smtp.sendmail 发送失败但无报错是因为 auth 为 nil 时走明文协议,被现代邮箱服务静默丢弃;邮件头未正确 mime 编码会导致中文乱码;并发过高会触发限频或封 ip,需限流控制。

smtp.SendMail 发送失败但没报错?检查 auth 参数是否为空
Go 的 smtp.SendMail 函数在 auth 为 nil 时不会主动拒绝,而是直接走明文 SMTP 协议 —— 大多数现代邮件服务(如 Gmail、Outlook、腾讯企业邮箱)会直接断连或静默丢弃,返回的 error 却可能是 <nil></nil>,让人误以为发送成功。
实操建议:
立即学习“go语言免费学习笔记(深入)”;
- 务必显式构造 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 头,客户端大概率解析失败或显示编码串。
实操建议:
立即学习“go语言免费学习笔记(深入)”;
- 不要拼接裸字符串,用
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?= <user>"</user>,不能只编码昵称部分而漏掉邮箱 - 避免用
fmt.Sprintf拼接换行符:Windows 行尾\r\n是强制要求,Linux 下用\n会导致部分服务器拒收
并发群发被限频或封 IP?控制 goroutine 数量 + 加随机延迟
SMTP 连接本身不支持批量投递,每封邮件都要新建 TCP 连接 + TLS 握手 + 认证 + 发送。盲目起几百个 goroutine,轻则被服务商限速(Gmail 通常 500 封/天/账号),重则 IP 被临时拉黑。
实操建议:
立即学习“go语言免费学习笔记(深入)”;
- 用带缓冲的 channel 限流,例如:
sem := make(chan struct{}, 5),每次发信前sem ,完成后 <code> - 两次连接间加
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 服务只认其中一种。
实操建议:
立即学习“go语言免费学习笔记(深入)”;
- 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 里,但没人提醒你。










