需先用net/mail.readmessage解析邮件头和正文,再用mime/multipart.newreader处理multipart正文;注意手动提取boundary、解码rfc5987编码字段、递归处理嵌套multipart、流式读取时控制长度避免错位。

如何用 mime/multipart 读取邮件原始内容
Go 的 mime/multipart 包本身不解析邮件头或识别 Message-ID、From 等字段,它只负责拆分 multipart boundary —— 所以你不能直接把一封完整的 RFC 5322 邮件丢给 multipart.NewReader 就完事。
必须先用 mail.ReadMessage(来自 net/mail)提取出邮件正文的 io.Reader,再把这个 reader 传给 multipart.NewReader。否则会报 malformed MIME header 或直接跳过所有 part。
- 错误做法:
multipart.NewReader(file, boundary)直接传整个 .eml 文件 - 正确链路:
mail.ReadMessage→ 获取msg.Header和msg.Body→ 检查Content-Type是否含multipart/→ 提取 boundary → 用multipart.NewReader(msg.Body, boundary) - 注意:boundary 通常在
msg.Header.Get("Content-Type")里,需手动正则提取,比如匹配boundary="...."或boundary=....(后者无引号)
multipart.Part 的 Header 解析容易漏掉编码字段
邮件里的 Content-Disposition 或 Content-Type 常含 filename*=UTF-8''... 这类 RFC 5987 编码,而 part.Header.Get("Filename") 只返回原始字符串,不会自动解码。
如果你直接用 part.Header.Get("Filename") 获取附件名,中文名大概率变成乱码或空字符串。
立即学习“go语言免费学习笔记(深入)”;
- 必须用
mail.ParseAddressList或第三方库如github.com/emersion/go-message/textproto来安全解码 - 更轻量的做法:用
mime.DecodeWord处理单个 header 值,例如mime.DecodeWord(part.Header.Get("Content-Disposition")) - 别依赖
part.FileName()方法 —— 它只对filename=形式有效,对filename*=返回空
嵌套 multipart(如 multipart/alternative + multipart/mixed)怎么递归处理
真实邮件常有多层嵌套:外层 multipart/mixed,里面一个 text/plain、一个 multipart/alternative,后者又包着 text/plain 和 text/html。Go 的 multipart.Reader 不自动递归,每层都得手动判断并新建 reader。
关键判断依据是当前 part 的 Content-Type 是否以 multipart/ 开头,且有 boundary。
- 调用
part.Header.Get("Content-Type"),用strings.HasPrefix(ct, "multipart/")判断 - 再从该 header 中提取 boundary(和第一层一样,需正则)
- 用
multipart.NewReader(part, boundary)创建子 reader,然后循环NextPart() - 递归深度建议限制(比如 ≤5),避免恶意构造的嵌套炸弹
附件流式保存时容易忽略 Part 的生命周期
multipart.Part 是一个带缓冲的 reader,底层绑定到父 reader 的字节流位置。一旦你读完一个 part,指针就前进了;如果中途 panic、没读完、或显式 close,后续 part 会读不到数据或错位。
最常见问题:用 ioutil.ReadAll(part) 读附件,但忘了检查是否真的读完了 —— 实际上 ReadAll 会一直读到 io.EOF,而这个 EOF 会“吃掉”下一个 part 的开头几个字节,导致后续 NextPart() 失败或内容损坏。
- 务必用
io.Copy(dst, part)或io.CopyN配合已知大小(从Content-Lengthheader 获取)来控制读取长度 - 如果要校验或转码,先
bytes.Buffer暂存,再处理,避免多次读取同一 part - 不要 defer
part.Close()——Part没实现io.Closer,调用会 panic










