Golang如何发送带附件的电子邮件 SMTP协议与MIME封装指南

在golang中发送带附件的邮件需先构造mime格式并连接smtp服务器。1. 使用smtp.plainauth进行身份验证并配置tls加密；2. 构造邮件内容，若带附件则采用multipart/mixed类型的mime结构，包含文本和附件部分，并正确设置boundary、content-type及content-disposition；3. 可手动拼接mime或使用第三方库如email简化流程；4. 注意事项包括：确保编码正确、避免垃圾邮件触发、处理附件大小限制及中文文件名乱码问题。掌握这些步骤后，用go实现邮件发送较为简单。

发邮件带附件在Golang里其实不难，但涉及SMTP和MIME格式的细节比较多。关键点在于正确构造邮件内容结构，特别是MIME部分的分隔与类型声明。

SMTP发送邮件的基础配置

要使用Go发送邮件，首先要连接到SMTP服务器并进行身份验证。常见的邮箱服务比如Gmail、QQ邮箱等都支持标准的SMTP协议。

auth := smtp.PlainAuth("", "your_email@example.com", "your_password", "smtp.example.com")
err := smtp.SendMail("smtp.example.com:587", auth, "your_email@example.com", []string{"to@example.com"}, []byte(msg))

上面代码中的msg是你构造好的邮件内容。这里需要注意：

立即学习“go语言免费学习笔记（深入）”；

• 使用TLS加密（端口587或465）更安全；
• 不同邮箱服务商的SMTP地址不同；
• 密码可能不是你的登录密码，而是“应用专用密码”；
• 有些服务商需要启用SMTP权限。

如果只是纯文本邮件，直接拼接字符串就可以。但一旦要加附件，就得用MIME格式来包装内容。

MIME格式详解：如何封装附件

电子邮件支持多种内容类型靠的是MIME（Multipurpose Internet Mail Extensions）。带附件的邮件通常是一个“multipart/mixed”类型的MIME消息，里面包含正文和一个或多个附件部分。

基本结构如下：

• 邮件头
• 分隔符 boundary 开始
  • 第一部分：正文（text/plain 或 text/html）
  • 分隔符再次出现
  • 第二部分：附件（application/octet-stream），需设置Content-Disposition
• 结束boundary

你可以手动拼接这个结构，也可以使用第三方库简化流程。例如 email 这个包就很好用：

Flowith

一款GPT4驱动的节点式 AI 创作工具

下载

e := email.NewEmail()
e.From = "Test "
e.To = []string{"recipient@example.com"}
e.Subject = "带附件的测试邮件"
e.Text = []byte("这是一封带附件的邮件示例。")

// 添加附件
_, err := e.AttachFile("example.txt")
if err != nil {
    log.Fatal(err)
}

// 发送
err = e.Send("smtp.example.com:587", auth)

如果你不想引入额外依赖，手动构造MIME也是可行的，但需要注意以下几点：

• 每个部分之间必须用相同的boundary分隔；
• boundary前必须加两个短横线 --；
• 最后一行boundary要以 -- 结尾；
• 设置正确的Content-Type和Content-Disposition字段；
• 附件内容需要用base64编码。

常见问题与注意事项

• 附件无法打开：可能是编码错误或MIME结构不对，检查是否漏掉boundary或Content-Type写错；

• 被识别为垃圾邮件：确保邮件标题和正文不要太简单，避免触发关键词过滤；

• 附件大小限制：不同邮箱对附件大小有限制，一般不能超过20MB；

• 多附件处理：每个附件都要作为一个独立的MIME块插入；

• 中文文件名乱码：使用RFC 2231编码格式处理文件名，如：

  Content-Disposition: attachment; filename*="utf-8''%E6%B5%8B%E8%AF%95.txt"

基本上就这些。虽然看起来步骤不少，但只要熟悉了MIME结构和SMTP流程，用Go实现带附件的邮件发送并不复杂。