理解net/smtp的邮件内容结构
在使用go语言的net/smtp包发送邮件时，开发者常会遇到邮件发送成功但收件人邮箱中不显示发件人信息（或显示为未知发件人）的问题，甚至导致邮件直接进入垃圾箱。这通常不是因为smtp.sendmail函数本身的问题，而是对msg参数的理解有误。
smtp.SendMail函数的msg参数并非仅仅指邮件的正文内容。它实际上期望接收一个包含完整邮件结构（包括所有必要的邮件头部信息和邮件正文）的字符串，然后将其转换为字节切片。这些头部信息，如From（发件人）、To（收件人）、Subject（主题）等，对于邮件客户端正确解析和显示邮件至关重要。
核心要点： 邮件的头部信息与邮件正文之间必须使用两个连续的换行符（\r\n\r\n）进行分隔。这是MIME邮件格式的基本要求。
正确构建邮件内容字符串（含头部信息）
为了确保邮件能够正确显示发件人信息并被邮件服务商正常处理，我们需要手动构建包含头部信息的邮件内容字符串。一个典型的邮件内容字符串结构如下：
From: 发件人名称 <发件人邮箱地址> To: 收件人邮箱地址 Subject: 邮件主题 Content-Type: text/plain; charset=UTF-8 邮件正文内容
请注意以下几点：
立即学习“go语言免费学习笔记（深入）”；
- 头部格式： 每个头部字段都应遵循Header-Name: Header Value的格式。
-
From头部： 推荐格式为发件人名称 ，例如From: Go Mailer
。 - 分隔符： 头部信息与邮件正文之间必须使用两个回车换行符（\r\n\r\n）进行分隔。单个\r\n用于分隔不同的头部字段。
- Content-Type： 建议添加Content-Type头部，明确邮件的类型（如text/plain或text/html）和字符编码（如UTF-8），以避免乱码问题。
Go语言示例代码
以下是一个完整的Go语言示例，演示如何使用net/smtp包发送一封包含正确发件人地址及其他头部信息的邮件：
package main
import (
"fmt"
"log"
"net/smtp"
"strings"
)
// sendEmailWithProperHeaders 函数用于发送一封带有完整头部信息的邮件
func sendEmailWithProperHeaders(
smtpHost string, // SMTP服务器主机名
smtpPort string, // SMTP服务器端口
username string, // 用于SMTP认证的用户名（通常是发件邮箱）
password string, // 用于SMTP认证的密码或授权码
fromEmail string, // 邮件From头中显示的发件人邮箱地址
fromName string, // 邮件From头中显示的发件人名称
toEmail string, // 收件人邮箱地址
subject string, // 邮件主题
body string, // 邮件正文内容
) error {
// 拼接SMTP服务器地址和端口
addr := smtpHost + ":" + smtpPort
// 创建SMTP认证器。PlainAuth需要用户名、密码和SMTP服务器主机名。
// 注意：username和password是用于SMTP服务器认证的凭据。
auth := smtp.PlainAuth("", username, password, smtpHost)
// 使用strings.Builder高效构建邮件头部和正文
msgBuilder := strings.Builder{}
// 添加邮件头部信息，每个头部字段后跟一个回车换行符（\r\n）
msgBuilder.WriteString(fmt.Sprintf("From: %s <%s>\r\n", fromName, fromEmail))
msgBuilder.WriteString(fmt.Sprintf("To: %s\r\n", toEmail))
msgBuilder.WriteString(fmt.Sprintf("Subject: %s\r\n", subject))
// 推荐添加Content-Type和Charset，避免乱码
msgBuilder.WriteString("Content-Type: text/plain; charset=UTF-8\r\n")
// 关键：头部信息与邮件正文之间使用两个回车换行符（\r\n\r\n）进行分隔
msgBuilder.WriteString("\r\n")
// 添加邮件正文
msgBuilder.WriteString(body)
// 将构建好的字符串转换为字节切片作为smtp.SendMail的msg参数
message := msgBuilder.String()
// smtp.SendMail的to参数是一个字符串切片，包含实际的收件人邮箱地址
to := []string{toEmail}
// 调用smtp.SendMail发送邮件
// 参数：SMTP服务器地址，认证信息，发件人邮箱（用于SMTP事务），收件人邮箱列表，邮件内容（含头部）
err := smtp.SendMail(addr, auth, fromEmail, to, []byte(message))
if err != nil {
return fmt.Errorf("发送邮件失败: %w", err)
}
return nil
}
func main() {
// 请替换为你的实际SMTP服务器信息和邮箱凭据
// 例如：smtp.qq.com, smtp.gmail.com, smtp.163.com
smtpHost := "smtp.example.com"
smtpPort := "587" // 常用端口：587 (TLS), 465 (SSL)
username := "your_smtp_username@example.com" // SMTP认证用户名，通常是邮箱地址
password := "your_smtp_password" // 邮箱授权码或密码（非登录密码）
// 邮件内容设置
fromEmail := "sender@example.com" // 邮件From头显示的发件人邮箱
fromName := "Go Mailer Service" // 邮件From头显示的发件人名称
toEmail := "recipient@example.com" // 收件人邮箱
subject := "Go语言SMTP邮件头部正确设置示例"
body := "您好，这是一封通过Go语言`net/smtp`发送的测试邮件。\n\n此邮件已正确设置发件人地址及其他头部信息，确保在邮件客户端中正常显示。"
// 调用函数发送邮件
err := sendEmailWithProperHeaders(
smtpHost, smtpPort, username, password,
fromEmail, fromName, toEmail, subject, body,
)
if err != nil {
log.Fatalf("邮件发送失败: %v", err)
}
fmt.Println("邮件发送成功！请检查收件箱。")
}
注意事项与最佳实践
-
发件人身份与认证信息的分离：
- smtp.PlainAuth中的username和password是用于向SMTP服务器证明发送者身份的凭据。
- 邮件头部中的From字段（例如From: Go Mailer
）是邮件接收方客户端用于显示发件人信息的。 - smtp.SendMail的第三个参数from（在示例中是fromEmail）是SMTP协议中MAIL FROM命令使用的发件人地址，它告诉SMTP服务器邮件的实际来源。
- 通常情况下，这三者（认证用户名、From头部邮箱、smtp.SendMail的from参数）应该保持一致，即都是你的发件邮箱地址，以确保邮件能被正确发送和识别。
-
邮件编码与MIME类型：
- 为避免邮件内容出现乱码，强烈建议在邮件头部中明确指定Content-Type和charset。例如：
- 纯文本邮件：Content-Type: text/plain; charset=UTF-8
- HTML邮件：Content-Type: text/html; charset=UTF-8
- 对于包含附件或复杂内容的邮件，需要构建更复杂的MIME多部分（multipart）结构，这超出了smtp.SendMail的简单msg字符串处理范围，通常需要借助第三方库（如go-gomail）或手动构建MIME结构。
- 为避免邮件内容出现乱码，强烈建议在邮件头部中明确指定Content-Type和charset。例如：
-
安全性（TLS/SSL）：
-
错误处理：
- 始终检查smtp.SendMail函数的返回值，及时捕获并处理可能发生的错误，例如网络问题、认证失败、SMTP服务器拒绝等。
