Golang邮件发送器详解：net/smtp使用教程

本文深入剖析了 Go 语言中使用 net/smtp 发送邮件的四大核心陷阱与最佳实践：认证失败却无错误提示（因 auth 为空导致静默跳过，需强制校验非 nil）、中文乱码问题（必须用 mime.FormatAddress 和 mime.WordEncoder 进行 MIME 编码，禁用手动拼接）、超时卡死风险（推荐 context.WithTimeout 结合自定义 net.Dialer 统一控制全链路时限），以及附件损坏隐患（务必通过 multipart.NewWriter 自动生成 boundary 并调用 Close()，中文文件名还需 mime.BEncoding.Encode）。这些看似隐蔽的问题往往只在生产环境特定邮箱或网络条件下爆发，唯有结合边界检查、真实 SMTP 联调和标准化编码才能真正规避。

smtp.SendMail 发送失败但没报错？检查 auth 参数是否为空

Go 的 smtp.SendMail 函数不会自动拒绝 nil 或空的 auth 参数，而是会静默跳过认证——结果就是大多数邮件服务商（如 Gmail、Outlook）直接拒收，返回 530 未认证错误，但 Go 层面不抛异常，err 为 nil，容易误判为“发送成功”。

• 必须显式传入非 nil 的认证对象，比如 smtp.PlainAuth，即使服务商支持无密码的 OAuth2，也要用对应 auth 实现
• Gmail 等已禁用“低安全性应用访问”，必须用 App Password 或 OAuth2，不能用账户明文密码
• 测试时加一句 if auth == nil { log.Fatal("missing auth") }，比事后查日志快得多

From 和 To 字段含中文就乱码？别手动拼接邮件头

直接在 to 或 from 字符串里写中文（如 "张三 "），SMTP 协议不识别 UTF-8，接收方客户端大概率显示问号或拆成乱码。标准库不处理 MIME 编码，得自己包一层。

• 用 mime.FormatAddress 生成合规的 From/To 字段：mime.FormatAddress("张三", "zhang@example.com") → "=?UTF-8?B?5byg5LiJ?= "
• 整个邮件正文（包括 Subject）也需用 mime.WordEncoder 编码，否则中文主题在 Outlook 里可能被截断
• 别依赖 fmt.Sprintf 拼接头部字段，SMTP 头部换行和空格敏感，一不小心就触发 501 Syntax error

发信超时卡死？设置 deadline 比调大 timeout 更可靠

smtp.SendMail 底层用 net.Dial 建连 + bufio.ReadWriter 交互，若网络中间件丢包或防火墙静默丢弃 SYN 包，它可能卡在 DNS 解析、TCP 握手或 SMTP 命令响应阶段，且默认无超时。

• 不要只设 net.DialTimeout，要对连接后所有 I/O 统一控时：用 net.Dialer{Timeout: 10 * time.Second, KeepAlive: 30 * time.Second} + conn.SetDeadline
• 更稳妥的做法是用 context.WithTimeout 包裹整个流程，配合自定义 net.Conn 实现，避免阻塞 goroutine
• 常见坑：本地开发用 127.0.0.1:25 测试时，Postfix/MailHog 启动慢，超时设太短（如 1s）会导致频繁失败，建议最低 5 秒

附件内容损坏？multipart.Writer 的边界符必须唯一且不可见

用 mime/multipart 构造带附件的邮件时，如果手动指定 boundary 字符串（如 "--myboundary"），而正文里恰好出现相同字符串，接收方解析器会提前切分，导致附件内容被截断或错位。

• 永远用 multipart.NewWriter 自动生成 boundary：w := multipart.NewWriter(buf)，然后用 w.Boundary() 获取值，别硬编码
• 写完每个 part 后必须调用 w.Close()，否则结尾 boundary 缺失，部分邮箱（如 Apple Mail）会忽略整个附件
• 附件文件名含中文？用 mime.BEncoding.Encode 编码 Content-Disposition 的 filename 参数，否则 iOS 邮件客户端可能显示空白名

最麻烦的不是写不对，是错误藏得深：认证失败不报错、中文乱码只在特定客户端出、超时卡住没日志、附件少几个字节却无法复现——这些都得靠边界检查和真实 SMTP 服务联调才能暴露。

以上就是本文的全部内容了，是否有顺利帮助你解决问题？若是能给你带来学习上的帮助，请大家多多支持golang学习网！更多关于Golang的相关知识，也可关注golang学习网公众号。