Golangnet/smtp发邮件详细教程
时间:2026-02-13 10:06:39 472浏览 收藏
偷偷努力,悄无声息地变强,然后惊艳所有人!哈哈,小伙伴们又来学习啦~今天我将给大家介绍《Golang使用net/smtp发邮件教程》,这篇文章主要会讲到等等知识点,不知道大家对其都有多少了解,下面我们就一起来看一吧!当然,非常希望大家能多多评论,给出合理的建议,我们一起学习,一起进步!
smtp.SendMail 发送失败但无报错是因为 auth 为 nil 时走明文协议,被现代邮箱服务静默丢弃;邮件头未正确 MIME 编码会导致中文乱码;并发过高会触发限频或封 IP,需限流控制。

smtp.SendMail 发送失败但没报错?检查 auth 参数是否为空
Go 的 smtp.SendMail 函数在 auth 为 nil 时不会主动拒绝,而是直接走明文 SMTP 协议 —— 大多数现代邮件服务(如 Gmail、Outlook、腾讯企业邮箱)会直接断连或静默丢弃,返回的 error 却可能是 ,让人误以为发送成功。
实操建议:
- 务必显式构造 auth:用
smtp.PlainAuth或smtp.LoginAuth,即使服务商声称“支持无认证”,实际也需提供合法凭据 - Gmail 必须开启「App Password」并用它替代账户密码;普通密码会触发 534 错误:
534 5.7.9 Application-specific password required - 腾讯企业邮箱要求使用「授权码」而非登录密码,且 SMTP 地址必须是
smtp.exmail.qq.com:465(不是smtp.qq.com) - 测试时加一行日志:
fmt.Printf("auth: %+v\n", auth),确认非 nil 且 username 字段不为空字符串
邮件正文乱码或收件人显示为 "=?UTF-8?B?..."?手动构造 MIME 头部
Go 标准库不自动处理邮件头编码,SendMail 只负责发原始字节流。如果 Subject 或 To 中含中文,又没加 MIME-Version 和 Content-Type 头,客户端大概率解析失败或显示编码串。
实操建议:
- 不要拼接裸字符串,用
strings.Builder构建完整邮件体,头部必须包含:MIME-Version: 1.0、Content-Type: text/plain; charset=utf-8、Subject: =?UTF-8?B?... - 中文 subject 建议用
mime.BEncoding.Encode编码:mime.BEncoding.Encode("utf-8", "你好")→=?utf-8?B?6L+Z5piv?= - To/From 字段若含中文昵称,格式应为:
"=?UTF-8?B?5byg5LiJ?=,不能只编码昵称部分而漏掉邮箱" - 避免用
fmt.Sprintf拼接换行符:Windows 行尾\r\n是强制要求,Linux 下用\n会导致部分服务器拒收
并发群发被限频或封 IP?控制 goroutine 数量 + 加随机延迟
SMTP 连接本身不支持批量投递,每封邮件都要新建 TCP 连接 + TLS 握手 + 认证 + 发送。盲目起几百个 goroutine,轻则被服务商限速(Gmail 通常 500 封/天/账号),重则 IP 被临时拉黑。
实操建议:
- 用带缓冲的 channel 限流,例如:
sem := make(chan struct{}, 5),每次发信前sem ,完成后<-sem - 两次连接间加
time.Sleep(time.Millisecond * time.Duration(100 + rand.Intn(200))),避免请求完全同步打到服务器 - 别复用同一个
smtp.Client实例发多封邮件:Go 的smtp.Client不是线程安全的,且多数服务端会在空闲 30 秒后断连 - 记录每封邮件的
rcptTo和返回状态(如250 OK),失败时单独重试,不要整批回滚
用 smtp.PlainAuth 还是 smtp.LoginAuth?看服务商文档再选
两者都实现 smtp.Auth 接口,但握手流程不同:PlainAuth 在 AUTH 命令中一次性提交 base64(user\0user\0pass),LoginAuth 则分步交互(先 AUTH LOGIN,再分别发编码后的 user/pass)。部分老旧或定制 SMTP 服务只认其中一种。
实操建议:
- Gmail / Outlook / 阿里云邮件推送:只支持
PlainAuth,用LoginAuth会返回504 5.5.2 Unrecognized authentication type - 某些内网 Exchange 或 Postfix 自建服务:可能禁用 PLAIN 机制,只开 LOGIN,此时必须用
LoginAuth - 调试时抓包看 AUTH 行:用
tcpdump -i any port 465 -w smtp.pcap,Wireshark 打开后过滤smtp.req.command == "AUTH",确认实际协商的是 LOGIN 还是 PLAIN - 别硬编码机制名 —— 先尝试
PlainAuth,捕获 error 后 fallback 到LoginAuth,而不是靠猜测
最常被忽略的是:邮件正文末尾必须有且仅有一个 \r\n.\r\n(CRLF + 点 + CRLF)作为结束标记,少一个字符或错用 \n.\n,服务器就卡住不响应,超时后才报错。这个点藏在 RFC 5321 里,但没人提醒你。
以上就是《Golangnet/smtp发邮件详细教程》的详细内容,更多关于的资料请关注golang学习网公众号!
-
505 收藏
-
503 收藏
-
502 收藏
-
502 收藏
-
502 收藏
-
101 收藏
-
461 收藏
-
324 收藏
-
374 收藏
-
463 收藏
-
420 收藏
-
408 收藏
-
201 收藏
-
442 收藏
-
380 收藏
-
277 收藏
-
317 收藏
-
- 前端进阶之JavaScript设计模式
- 设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
- 立即学习 543次学习
-
- GO语言核心编程课程
- 本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
- 立即学习 516次学习
-
- 简单聊聊mysql8与网络通信
- 如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
- 立即学习 500次学习
-
- JavaScript正则表达式基础与实战
- 在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
- 立即学习 487次学习
-
- 从零制作响应式网站—Grid布局
- 本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
- 立即学习 485次学习