Golangnet/smtp发邮件教程详解

你在学习Golang相关的知识吗？本文《Golang使用net/smtp发送邮件教程》，主要介绍的内容就涉及到，如果你想提升自己的开发能力，就不要错过这篇文章，大家要知道编程理论基础和实战操作都是不可或缺的哦！

Go中用net/smtp发邮件需手动构造RFC 5322格式邮件内容，支持纯文本、HTML及附件（需MIME多部分），通过smtp.SendMail连接认证后发送，注意Gmail等平台需App Password及DNS验证。

在 Go 中使用 net/smtp 发送邮件，核心是构造符合 SMTP 协议的邮件内容（即 RFC 5322 格式），再通过 SMTP 客户端连接并认证后发送。它不提供高级邮件构建能力（如 HTML、附件、内嵌图片等需手动处理 MIME），但足够轻量、可控。

构造标准邮件内容（纯文本或 HTML）

Go 标准库没有内置邮件构建器，需手动拼接邮件头与正文，用 \r\n 分隔，头部与正文间空一行。关键字段包括 From、To、Subject、Date 和 MIME-Version。

例如发送纯文本邮件：

msg := []byte("To: recipient@example.com\r\n" +
    "From: sender@example.com\r\n" +
    "Subject: Hello from Go\r\n" +
    "MIME-Version: 1.0\r\n" +
    "Content-Type: text/plain; charset=utf-8\r\n" +
    "\r\n" +
    "This is a plain text email sent via net/smtp.")

若要发送 HTML 邮件，将 Content-Type 改为 text/html，并在正文中写 HTML 片段：

"Content-Type: text/html; charset=utf-8\r\n" +
"\r\n" +
"<h1>Hello</h1><p>This is <b>HTML</b>.</p>"

处理带附件的邮件（手动构造 MIME 多部分）

附件需使用 multipart/mixed 结构，边界（boundary）需唯一且不与正文冲突。建议用 mime/multipart 包辅助构造：

• 创建 bytes.Buffer 作为输出缓冲区
• 用 multipart.NewWriter 写入 multipart 数据，设置随机 boundary
• 先写文本/HTML 部分（multipart/alternative 可选），再写附件部分（application/octet-stream）
• 调用 w.Close() 自动写入 final boundary 和尾部

注意：附件文件需读取为字节，用 part.Write() 写入；文件名应通过 Content-Disposition 头指定，如：attachment; filename="report.pdf"。

建立 SMTP 连接并发送

使用 smtp.SendMail 最简，但仅支持 PLAIN 或 LOGIN 认证（不支持 OAuth2）。需提供：

• SMTP 服务器地址（如 "smtp.gmail.com:587"）
• 身份认证信息（smtp.PlainAuth）：用户名、密码、主机名（用于 HELO）、邮箱地址
• 发件人地址（必须与认证账号一致，尤其 Gmail/Outlook 等平台）
• 收件人列表（字符串切片）
• 完整邮件字节数据（含头+正文）

示例：

auth := smtp.PlainAuth("", "user@gmail.com", "app-password", "smtp.gmail.com")
err := smtp.SendMail("smtp.gmail.com:587", auth, "user@gmail.com", []string{"to@example.com"}, msg)

⚠️ 注意：Gmail 要求开启“两步验证”并生成 App Password；国内企业邮箱常需开启 SMTP 服务并检查端口（587 或 465）及 TLS 设置。

发送前校验与错误处理

常见失败点包括：

• 邮箱格式错误（用 mail.ParseAddress 或正则预检）
• SMTP 认证失败（用户名/密码错、App Password 过期、未开 SMTP）
• 邮件头缺失或格式非法（如缺少 \r\n、Subject 含换行）
• 被目标服务器拒收（SPF/DKIM/DMARC 验证失败，建议配置发信域名 DNS 记录）

建议对 SendMail 返回的 error 做区分处理：网络错误可重试，认证失败需提示用户检查凭据，协议错误（如 5xx 响应）需解析 SMTP 错误码进一步诊断。

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