Go语言net/smtp邮件发送教程

本文深入剖析了Go语言使用net/smtp发送邮件时四大典型陷阱：认证为空导致静默失败（如Gmail拒收却无错误）、中文收件人/主题乱码需借助mime.FormatAddress和WordEncoder规范编码、网络超时卡死必须结合net.Dialer与context.WithTimeout统一管控、附件损坏源于手动指定boundary或遗漏multipart.Writer.Close()；每处都直击生产环境真实痛点，并给出可立即落地的防御性写法和调试技巧，助你避开那些“看似成功实则失效”的隐形雷区。

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 服务联调才能暴露。

以上就是《Go语言net/smtp邮件发送教程》的详细内容，更多关于的资料请关注golang学习网公众号！