Go 中使用 smtp.SendMail 发送多收件人邮件的正确方法

本文详解 go 标准库 smtp.sendmail 如何正确支持多个收件人，指出常见数组格式错误、smtp 协议限制及邮件头构造要点，并提供标准库与 gomail 库两种生产级实现方案。

本文详解 go 标准库 smtp.sendmail 如何正确支持多个收件人，指出常见数组格式错误、smtp 协议限制及邮件头构造要点，并提供标准库与 gomail 库两种生产级实现方案。

在 Go 中调用 net/smtp.SendMail 发送多收件人邮件时，一个典型误区是将多个邮箱地址拼接成单个字符串并放入切片中（如 []String{“a@example.com, b@example.com”}），这会导致 SMTP 服务器返回 501 Syntax Error in arguments 错误——因为 SendMail 的第四个参数 to []string 要求每个元素必须是独立、合法的邮箱地址，而非逗号分隔的字符串。

✅ 正确写法：每个收件人地址单独作为切片的一个元素：

to := []string{     "alice@yahoo.com",     "bob@gmail.com",     "charlie@outlook.com", } err := smtp.SendMail(     "smtp.mail.yahoo.com:587", // 建议使用 587（STARTTLS）而非已弃用的 25 端口     auth,     "sender@yahoo.com", // from 地址（必须与认证账号一致）     to,                 // ✅ 切片内各元素为独立邮箱     []byte(msg),        // 构造完整的 RFC 5322 邮件正文（含 From/To/Subject 等头） )

⚠️ 关键注意事项：

• to 参数仅用于 SMTP RCPT TO 命令：它控制邮件实际投递的目标地址（即 SMTP 层收件人），不决定邮件头中的 To: 字段显示内容。后者需手动写入 msg 字节流中。
• 邮件头 To: 必须显式构造：SendMail 不自动解析或填充邮件头。若希望收件人在客户端看到多个收件人，需在 []byte(msg) 中完整写出符合 RFC 规范的头部，例如：

  msg := []byte(`To: Alice <alice@yahoo.com>, Bob <bob@gmail.com> From: "Test Sender" <sender@yahoo.com> Subject: Hello from Go MIME-Version: 1.0 Content-Type: text/plain; charset="utf-8"

this is a test email sent to multiple recipients.`)

- **Yahoo SMTP 要求严格认证与端口**：务必使用 `auth = smtp.PlainAuth("", "sender@yahoo.com", "app-password", "smtp.mail.yahoo.com")`，且推荐端口 `587` + STARTTLS（需用 `gomail` 或自行封装 TLS）；纯 `:25` 易被拒绝或限流。 - **避免邮箱地址格式错误**：确保所有地址为标准 `local@domain.tld` 格式，无空格、换行或 HTML 实体（如原始问题中混淆的 `<a>` 标签和 `data-cfemail` 加密内容需解密还原为真实邮箱）。  ? 更推荐方案：使用 `gomail`（现代、健壮、易维护）  标准库 `smtp.SendMail` 功能简陋，缺乏 MIME 构建、附件、HTML 支持及自动 TLS 协商。生产环境强烈建议使用社区成熟库 `gomail`（v2）：  ```go package main  import (     "log"     "gopkg.in/gomail.v2" )  func main() {     m := gomail.NewMessage()     m.SetAddressHeader("From", "sender@yahoo.com", "Test Sender")     m.SetHeader("To",         m.FormatAddress("alice@yahoo.com", "Alice"),         m.FormatAddress("bob@gmail.com", "Bob"),     )     m.SetHeader("Subject", "Hello from Go (Multiple Recipients)")     m.SetBody("text/plain", "This email was sent to both Alice and Bob.")      // 自动协商 STARTTLS，支持 Yahoo / Gmail / Outlook 等主流服务商     d := gomail.NewDialer("smtp.mail.yahoo.com", 587, "sender@yahoo.com", "your-app-password")      if err := d.DialAndSend(m); err != nil {         log.Fatal("Failed to send email:", err)     }     log.Println("Email sent successfully!") }

? 总结：

• smtp.SendMail 的 to []string 是 SMTP 协议层面的收件人列表，必须为纯净邮箱字符串切片；
• 邮件头 To: 需手动构造，二者需逻辑一致；
• 直接使用标准库易出错，gomail 提供类型安全、自动编码、TLS 封装和清晰 API，应作为默认选择；
• 始终使用应用专用密码（App Password）替代账户密码，并启用两步验证（Yahoo/Gmail 均强制要求）。