本文详解go标准库net/smtp发送多收件人邮件时的常见错误（如语法错误501、收件人未生效），指出addr参数必须为字符串切片且每个邮箱独立成项，并提供标准库原生写法与更健壮的gomail替代方案。
本文详解go标准库net/smtp发送多收件人邮件时的常见错误（如语法错误501、收件人未生效），指出addr参数必须为字符串切片且每个邮箱独立成项，并提供标准库原生写法与更健壮的gomail替代方案。
在Go中使用smtp.SendMail向多个收件人发送邮件时，一个高频陷阱是误将多个邮箱地址拼接为单个字符串传入收件人切片——这会导致SMTP服务器解析失败（典型报错：501 Syntax error in arguments），甚至仅向第一个地址发信。根本原因在于：smtp.SendMail的第四个参数to []string要求每个元素必须是格式合法、不含分隔符的独立邮箱地址，而非逗号连接的字符串。
✅ 正确用法：收件人切片需严格拆分为独立字符串
以下为修复后的标准库调用示例（以Yahoo SMTP为例）：
package main
import (
"log"
"net/smtp"
)
func main() {
auth := smtp.PlainAuth("", "your_email@yahoo.com", "your_app_password", "smtp.mail.yahoo.com")
// ❌ 错误：将多个邮箱拼成一个字符串
// []string{"alice@yahoo.com, bob@gmail.com"}
// ✅ 正确：每个邮箱为独立切片元素
to := []string{
"alice@yahoo.com", // 收件人1
"bob@gmail.com", // 收件人2
"charlie@outlook.com", // 收件人3
}
msg := []byte("To: alice@yahoo.com, bob@gmail.com, charlie@outlook.com\r\n" +
"From: your_email@yahoo.com\r\n" +
"Subject: Test Multi-Recipient Email\r\n" +
"MIME-Version: 1.0\r\n" +
"Content-Type: text/plain; charset=utf-8\r\n\r\n" +
"Hello! This email was sent to multiple recipients successfully.")
err := smtp.SendMail(
"smtp.mail.yahoo.com:587", // 注意：Yahoo推荐使用587端口（STARTTLS）
auth,
"your_email@yahoo.com",
to,
msg,
)
if err != nil {
log.Fatal("SendMail failed:", err)
}
log.Println("Email sent to all recipients!")
}⚠️ 关键注意事项：
- 端口选择：Yahoo SMTP建议使用 587（STARTTLS）或 465（SSL），而非已弃用的 25 端口；使用 25 易触发 501 错误或被拒绝。
- 认证凭据：务必使用Yahoo生成的「应用专用密码」（App Password），而非账户登录密码。
- 邮件头中的 To 字段：msg 内容中的 To: 行必须与 to []string 中的地址完全一致且顺序对应，否则部分客户端可能仅显示首个收件人。
- 字符编码与换行符：邮件头与正文间需用 \r\n\r\n 分隔，所有换行符必须为 CRLF（\r\n），否则SMTP协议校验失败。
? 推荐方案：使用 gomail 库简化开发
标准库对邮件结构（HTML/附件/多编码）支持有限，易出错。生产环境强烈推荐使用成熟的第三方库 gomail（v2+）：
立即学习“go语言免费学习笔记（深入）”；
package main
import (
"log"
"gopkg.in/gomail.v2"
)
func main() {
m := gomail.NewMessage()
m.SetAddressHeader("From", "your_email@yahoo.com", "Sender Name")
// 支持为每个收件人设置别名
m.SetHeader("To",
m.FormatAddress("alice@yahoo.com", "Alice Smith"),
m.FormatAddress("bob@gmail.com", "Bob Johnson"),
m.FormatAddress("charlie@outlook.com", "Charlie Brown"),
)
m.SetHeader("Subject", "Multi-Recipient Email via Gomail")
m.SetBody("text/plain", "Hi all! This message reached everyone.")
// m.Attach("/path/to/file.pdf") // 如需附件，一行搞定
d := gomail.NewDialer("smtp.mail.yahoo.com", 587, "your_email@yahoo.com", "app_password")
if err := d.DialAndSend(m); err != nil {
log.Fatal("Gomail send failed:", err)
}
log.Println("Gomail: Sent to all recipients with rich formatting!")
}gomail 的优势在于：
- 自动处理 MIME 头、编码、CRLF 换行；
- 支持 HTML 邮件、附件、内嵌图片；
- 提供清晰的 FormatAddress 方法管理昵称与邮箱；
- 内置重试机制与连接池，稳定性远超裸 smtp.SendMail。
✅ 总结
| 问题点 | 正确实践 |
|---|---|
| 收件人格式错误 | to []string 必须是 []string{"a@x.com", "b@y.com"}，禁止 []string{"a@x.com,b@y.com"} |
| SMTP端口失效 | Yahoo/Gmail等主流服务商禁用25端口，改用587（STARTTLS）或465（SSL） |
| 邮件头不匹配 | msg 中 To: 字段内容必须与 to []string 完全一致（含空格、顺序） |
| 生产级需求 | 优先选用 gomail 或 mailgun-go 等专业库，规避协议细节陷阱 |
遵循以上规范，即可稳定、可靠地实现Go语言多收件人邮件发送。
