当前位置：首页 > 文章列表 > Golang > Go教程 > GolangSMTP发邮件教程与代码示例

GolangSMTP发邮件教程与代码示例

2026-03-01 12:33:48 0浏览收藏

本文深入剖析了Go语言中使用SMTP发送邮件的常见陷阱与实战解决方案，重点揭示了认证失败（如Gmail的535错误）、TLS连接异常（如域名解析失败实为STARTTLS未启用）、MIME内容构建难题（HTML/附件需手动编码或借助gomail等库）以及云服务器端口封锁等典型问题，并给出可落地的代码示例和配置建议——从应用专用密码设置、tls.Dial与smtp.NewClient的手动流程控制，到multipart构建规范及第三方中继服务选型，帮你绕过文档碎片与平台限制，真正实现稳定可靠的邮件发送。

如何使用Golang的net/smtp发送邮件_Golang SMTP邮件发送示例

为什么 `net/smtp` 发送邮件总卡在 `Auth: 535 5.7.8 Error`

绝大多数失败不是因为代码写错，而是认证方式不匹配。Gmail、Outlook 等主流服务商默认禁用“密码直连”，必须用应用专用密码（App Password）或 OAuth2；而 smtp.PlainAuth 传的是明文凭据，一旦账号启用了两步验证，直接填邮箱密码必然报 535 5.7.8。

实操建议：

用 Gmail 时，去 Google 账户 → 安全 → 应用专用密码生成 16 位密码，替换掉邮箱密码
国内企业邮箱（如腾讯企业邮、阿里云企业邮）通常支持 SMTP 密码直连，但需确认是否开启 SMTP 服务且端口是 465（SSL）还是 587（TLS）
不要硬编码密码：用环境变量读取，例如 os.Getenv("SMTP_PASSWORD")

`smtp.SendMail` 报 `dial tcp: lookup smtp.gmail.com: no such host` 怎么办

这不是 DNS 问题，而是 Go 默认不自动升级 TLS —— 当你用 smtp.gmail.com:587 却没显式启用 STARTTLS，SendMail 就会尝试纯文本连接，被服务器拒绝后降级失败，最终表现为域名解析失败（实际是握手提前中断导致的误报）。

正确做法是自己建 tls.Config 并用 smtp.NewClient 手动控制流程：

conn, err := tls.Dial("tcp", "smtp.gmail.com:587", &tls.Config{ServerName: "smtp.gmail.com"})
if err != nil {
    log.Fatal(err)
}
client, err := smtp.NewClient(conn, "smtp.gmail.com")
if err != nil {
    log.Fatal(err)
}
if err = client.Auth(smtp.PlainAuth("", user, pass, "smtp.gmail.com")); err != nil {
    log.Fatal(err)
}

关键点：

smtp.SendMail 是便捷封装，只适合简单场景；只要涉及 TLS/SSL、自定义 Auth 或需要发多封邮件复用连接，就得走 NewClient 流程
ServerName 必须显式设为域名，不能是 IP，否则证书校验失败
Gmail 的 465 端口走隐式 SSL，应直接用 tls.Dial；587 是显式 TLS，需先 Dial("tcp", ...) 再 client.StartTLS(...)

发送带附件或 HTML 内容的邮件，`net/smtp` 能直接支持吗

不能。net/smtp 只负责传输层协议，不处理 MIME 编码。HTML 正文和附件都得自己拼好符合 RFC 2822 的原始字节流，稍有格式错误（比如换行符用 \n 而非 \r\n、boundary 冲突、base64 编码缺等号）就会被收件方当垃圾邮件或直接拒收。

推荐方案：

用 gomail.v2（轻量）或 mailgun-go（功能全），它们内部已处理 MIME、编码、header 转义
如果坚持原生，至少用标准库 mime/multipart 构建 body：

body := &bytes.Buffer{}
writer := multipart.NewWriter(body)
writer.SetBoundary("myboundary123")

// HTML part
part, _ := writer.CreatePart(map[string][]string{"Content-Type": {"text/html; charset=utf-8"}})
part.Write([]byte("<h1>Hello</h1>"))

// Attachment
part, _ = writer.CreatePart(map[string][]string{
    "Content-Type": {"application/pdf"},
    "Content-Disposition": {"attachment; filename=\"report.pdf\""},
})
io.Copy(part, file)

writer.Close() // 必须调用，否则 boundary 不闭合

注意：SetBoundary 的值不能含下划线或特殊字符，且必须全局唯一；Close() 不可省略。