Go中smtp.SendMail发送多收件人技巧

本文深入剖析了 Go 语言中使用标准库 `smtp.SendMail` 发送多收件人邮件的常见陷阱与正确实践，重点揭示了将多个邮箱拼接为单字符串导致 SMTP 501 错误的根本原因，并强调 `to []string` 参数必须是每个元素均为独立合法邮箱地址的切片，同时需手动构造符合 RFC 5322 规范的邮件头（如 `To:` 字段）——二者逻辑一致却职责分离；文章不仅给出可直接运行的标准库示例，更强烈推荐采用功能完备、自动处理 TLS/STARTTLS、MIME 编码和地址格式化的 `gomail` 库作为生产环境首选方案，辅以 Yahoo 等主流服务商的认证配置要点和安全最佳实践，助你避开坑、写出健壮可靠的邮件发送代码。

本文详解 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 均强制要求）。

今天关于《Go中smtp.SendMail发送多收件人技巧》的内容介绍就到此结束，如果有什么疑问或者建议，可以在golang学习网公众号下多多回复交流；文中若有不正之处，也希望回复留言以告知！