Go语言发送SMTP邮件详细教程

本文深入解析了Go语言中发送SMTP邮件的最佳实践，强调应优先选用轻量、稳定且功能完备的gomail库而非原生net/smtp包——它自动处理STARTTLS协商、认证降级、合规MIME结构与Message-ID生成，大幅简化HTML正文、附件添加等常见需求，同时规避裸包开发中频发的认证失败、垃圾邮件误判等“隐形坑”；文章还直击生产痛点，指出发信稳定性真正取决于SPF/DKIM/DMARC等基础设施配置，而gomail正是帮你快速跑通协议层、聚焦核心问题的可靠起点。

Go 语言原生 net/smtp 包能发邮件，但直接用它发带附件、HTML 正文或认证失败时的错误提示不明确——这不是“能不能”，而是“要不要自己填坑”。真要稳定发运营/告警邮件，别硬刚裸包。

用 gomail 发带 HTML 和附件的邮件最省事

gomail 是目前 Go 生态里最轻量又靠谱的 SMTP 邮件库，不依赖 cgo，API 清晰，错误反馈比原生包强得多。它把 net/smtp 的底层细节（比如 AUTH 命令顺序、MIME 分隔符生成）全封装好了。

安装：

go get gopkg.in/gomail.v2

基本发送示例：

package main

import (
    "gopkg.in/gomail.v2"
)

func main() {
    d := gomail.NewDialer("smtp.gmail.com", 587, "user@gmail.com", "app-password")
    m := gomail.NewMessage()
    m.SetHeader("From", "user@gmail.com")
    m.SetHeader("To", "receiver@example.com")
    m.SetHeader("Subject", "Hello from Go")
    m.SetBody("text/plain", "Hi there!")
    m.AddAlternative("text/html", "<h1>Hi there!</h1>")

    if err := d.DialAndSend(m); err != nil {
        panic(err) // 注意：这里会暴露密码字段，生产环境需日志脱敏
    }
}

常见注意点：

• gomail.NewDialer 第四个参数是应用专用密码（如 Gmail 开启两步验证后生成的 app password），不是账户登录密码
• 调用 m.AddAlternative 添加 HTML 版本前，必须先调用 m.SetBody 设置纯文本版本，否则部分邮箱客户端只显示空白
• 附件用 m.Attach("/path/to/file.pdf")，路径必须存在且进程有读权限；内存中构建的文件建议用 m.Attach("report.xlsx", gomail.SetCopyFunc(...))

net/smtp 手动发邮件时 AUTH 失败的典型原因

直接调 net/smtp 发送，最常见的报错是 535 5.7.8 Username and Password not accepted 或 432 4.3.2 Authentication mechanism not supported。根本不是密码错了，而是协议协商没对上。

关键点：

• Gmail / Outlook 等现代服务强制要求 STARTTLS，不能直连 465 端口再用 SSL（即所谓 SMTPS）；net/smtp 默认不自动升级加密，得手动调 smtp.Dial + c.StartTLS
• 认证方式默认只尝试 PLAIN，但某些企业邮箱只支持 LOGIN；gomail 内部会按服务器 EHLO 返回的 AUTH 列表自动降级尝试，裸包得自己写逻辑
• 用户名必须是完整邮箱地址（如 user@domain.com），不能只写 user；部分服务器对大小写敏感

发信被当垃圾邮件？检查这三处头信息

即使 SMTP 连接成功、认证通过，收件方仍可能扔进垃圾箱。核心不在内容，而在基础头字段是否合规：

• From 域名必须和 SMTP 认证账号域名一致（From: service@myapp.com → 必须用 myapp.com 的 SMTP 服务，不能混用 Gmail 账号发）
• 缺失 Message-ID 或格式非法（如含空格、无 @ 符）会导致部分 MX 服务器拒收；gomail 会自动生成合规值，裸包得自己用 fmt.Sprintf("<%s@%s>", uuid.NewString(), domain)
• 没设 Reply-To 且 From 是 no-reply@ 类地址时，用户点“回复”会失败，触发反垃圾策略加权

真正难的不是连上 SMTP 服务器，是让每封邮件都稳定抵达收件箱——域名 SPF/DKIM/DMARC 配置、IP 信誉、发信频率限制，这些都远超代码层面。先用 gomail 把协议层跑通，再逐项补基础设施。

终于介绍完啦！小伙伴们，这篇关于《Go语言发送SMTP邮件详细教程》的介绍应该让你收获多多了吧！欢迎大家收藏或分享给更多需要学习的朋友吧~golang学习网公众号也会发布Golang相关知识，快来关注吧！