Golang开发邮件服务教程

Go可用net/smtp发信、go-imap收信，需正确选协议端口、用标准Auth类型、设HTML头与CRLF换行、环境变量存密；收信须TLS加密、Gmail配应用密码；错误要细判状态码并分类重试。

Go 本身不内置邮件服务器，但用标准库 net/smtp 和第三方包（如 github.com/emersion/go-imap）能可靠实现发信与基础收信——关键不在“能不能”，而在“怎么选协议、配什么服务、绕开哪些坑”。

用 net/smtp 发邮件：别硬写认证逻辑，直接复用 smtp.Auth

很多人自己拼 Auth 字符串或手写 CRAM-MD5，其实 Go 标准库已封装好主流方式。Gmail、Outlook、阿里云邮箱等都支持 PLAIN 或 LOGIN 认证，直接调用现成类型即可。

常见错误：传错 host:port（比如 Gmail 用 smtp.gmail.com:587，不是 :465；而某些企业邮箱只认 :465 TLS 直连）。

• smtp.PlainAuth 最通用，参数顺序是 identity, username, password, host，identity 通常为空字符串
• 发 HTML 邮件时，必须设 Content-Type: text/html; charset=utf-8，且换行用 \r\n（不是 \n），否则 Outlook 可能渲染异常
• 避免在生产环境硬编码密码：改用环境变量读取 os.Getenv("SMTP_PASSWORD")，或通过配置中心注入

收邮件别碰原始 net/textproto，优先用 go-imap + go-imap-idle

IMAP 协议状态多、响应格式松散，自己解析 FETCH 响应极易出错（比如乱码、BODYSTRUCTURE 解析失败、UID 溢出）。社区成熟的 github.com/emersion/go-imap 封装了连接、认证、文件夹选择、消息抓取全流程。

典型陷阱：默认使用非加密的 imap:// 连接明文传输凭证；必须显式启用 TLS：

client, err := client.DialTLS("imap.gmail.com:993", nil)

或手动配置 TLS 后 Dial：

tlsConfig := &tls.Config{ServerName: "imap.gmail.com"}
client, err := client.Dial("imap.gmail.com:993")
if err == nil {
  client.StartTLS(tlsConfig)
}

• Gmail 需开启「IMAP 访问」并在账号里生成「应用专用密码」，普通登录密码会失败，报错类似 NO [AUTHENTICATIONFAILED] Invalid credentials
• 用 go-imap-idle 实现服务端推送监听时，注意超时重连逻辑——IDLE 连接可能被中间代理断开，需捕获 client.IdleDone() 错误并重建
• 解析邮件正文优先用 section.Body + message.GetBody()，别直接读 RawBody，否则附件和多部分 MIME 会混乱

发信失败时，看 smtp.SendMail 返回的具体错误，不是笼统判空

smtp.SendMail 返回的 error 是具体 SMTP 状态码包装体，比如 535 5.7.8 Username and Password not accepted 或 452 4.2.2 Mailbox full。直接打印 err.Error() 能看到完整响应，比检查 err != nil 有用得多。

• 常见可恢复错误：421（服务忙）、450（邮箱不可用），适合加指数退避重试
• 硬错误如 530（未认证）、550（用户不存在）应立刻告警，不重试
• 若用 gomail 等封装库，记得启用 .SetDebugWriter(os.Stdout) 查看原始 SMTP 交互流，定位 AUTH 失败或 RCPT 拒绝点

真正难的不是连上 SMTP/IMAP，而是处理现实世界的不一致：不同服务商对 RFC 的实现偏差、防火墙拦截 STARTTLS、Gmail 的 OAuth2 强制迁移、以及垃圾邮件过滤规则导致的送达率波动。上线前务必用真实邮箱账户走通全链路，别只测本地 mock。