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 封装了连接、认证、文件夹选择、消息抓取全流程。
立即学习“go语言免费学习笔记(深入)”;
基于Intranet/Internet 的Web下的办公自动化系统,采用了当今最先进的PHP技术,是综合大量用户的需求,经过充分的用户论证的基础上开发出来的,独特的即时信息、短信、电子邮件系统、完善的工作流、数据库安全备份等功能使得信息在企业内部传递效率极大提高,信息传递过程中耗费降到最低。办公人员得以从繁杂的日常办公事务处理中解放出来,参与更多的富于思考性和创造性的工作。系统力求突出体系结构简明
典型陷阱:默认使用非加密的 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。









