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

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

P粉602998670

发布： 2025-07-03 08:42:02

原创

313人浏览过

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

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

发邮件带附件在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 这个包就很好用：

e := email.NewEmail()
e.From = "Test <test@example.com>"
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"
```
登录后复制