Go 怎么解析邮件头里的中文主题和发件人

Go 解析邮件头时，先用 mail.ReadMessage 把原始邮件拆成头和正文，再分别处理字段：中文主题用 mime.WordDecoder.DecodeHeader，中文发件人用带 WordDecoder 的 mail.AddressParser。只调用 Header.Get 得到的通常还是 RFC 2047 编码词，不能直接当作最终中文显示。

先把原始邮件头和中文解码分成两层

邮件头遵循 RFC 5322 的字段结构，非 ASCII 文本常以 RFC 2047 encoded-word 形式出现，例如主题可能长成 =?UTF-8?B?...?=。因此解析顺序应是“先读字段，再解码字段”，而不是对整封邮件做字符串替换。

mail.ReadMessage 读取头部后返回 Message，其中 Header 保存字段，Body 仍是可继续读取的流。Header.Get 会按不区分大小写的方式取某个字段的第一个值，但它的职责只是取值，不是 MIME 解码。

中文主题直接交给 WordDecoder

主题是一个文本字段，最小处理方式是先取原始值，再调用 DecodeHeader。这个方法会处理一个头字段中可能出现的多个 encoded-word，并把可读文本拼接起来。

package main

import (
    "fmt"
    "log"
    "mime"
    "net/mail"
    "strings"
)

func main() {
    raw := "Subject: =?UTF-8?B?5L2g5aW977yM5LiK5Lq65ZCN5Y2w?=\r\n" +
        "From: =?UTF-8?B?5LiH5a2m?= \r\n" +
        "\r\n正文"

    // 先拆出头部；ReadMessage 不会替我们完成 MIME 文本解码。
    msg, err := mail.ReadMessage(strings.NewReader(raw))
    if err != nil {
        log.Fatal(err)
    }

    // DecodeHeader 负责还原 Subject 中的 RFC 2047 编码词。
    subject, err := (&mime.WordDecoder{}).DecodeHeader(msg.Header.Get("Subject"))
    if err != nil {
        log.Fatalf("解码主题失败: %v", err)
    }
    fmt.Println("主题:", subject)
}

这里的 Header.Get("Subject") 只是拿到第一个 Subject 值；如果业务允许重复头字段，应直接访问 Header 映射并逐个处理。输入不可信时也不要把解码错误吞掉，否则坏编码会被误判成正常标题。

发件人字段要用带解码器的 AddressParser

From 不只是文本，它还包含邮箱地址语法。只调用 DecodeHeader 再手动切尖括号，容易在多个地址、注释或异常输入上出错。更稳妥的方式是把 WordDecoder 注入 AddressParser，让标准库同时完成显示名和地址的拆分。

decoder := &mime.WordDecoder{}
parser := &mail.AddressParser{WordDecoder: decoder}

// 让地址解析器负责 From 的 RFC 5322 结构和显示名解码。
from, err := parser.Parse(msg.Header.Get("From"))
if err != nil {
    log.Fatalf("解析发件人失败: %v", err)
}

fmt.Println("显示名:", from.Name)
fmt.Println("邮箱:", from.Address)

如果要处理多个收件人或抄送人，使用同一个 parser.ParseList，不要简单按逗号切分，因为显示名和地址列表本身有 RFC 语法。

字符集和异常输入要显式处理

UTF-8、ASCII 这类输入可以直接交给默认解码器；老邮件可能声明 GBK 等字符集。mime.WordDecoder 提供 CharsetReader 扩展点，回调收到字符集名称和原始字节流后，应返回转换后的读取器。实际项目可接入 golang.org/x/text/encoding/simplifiedchinese，不要把 GBK 字节强行当 UTF-8。

import (
    "fmt"
    "io"
    "mime"
    "strings"
)

decoder := &mime.WordDecoder{
    // 对标准库默认不认识的字符集，在这里接入项目自己的转换器。
    CharsetReader: func(charset string, input io.Reader) (io.Reader, error) {
        switch strings.ToLower(charset) {
        case "utf-8", "us-ascii":
            return input, nil
        default:
            return nil, fmt.Errorf("不支持的邮件字符集: %s", charset)
        }
    },
}

这段回调展示的是边界，不是完整的 GBK 转换器：正式接入时把 default 分支换成经过测试的字符集解码器。与此同时，空的 Subject、缺少 From、坏地址和不支持的字符集都应形成可观测错误或明确降级，不能把原始乱码伪装成成功。

常见问题

为什么 Header.Get 取到的主题还是一串 =?UTF-8? 开头的文本？

因为 Get 只取字段值，调用 mime.WordDecoder.DecodeHeader 才会按 RFC 2047 还原主题。

From 能不能先 DecodeHeader 再按 截取？

不建议。From 是地址列表语法，使用带 WordDecoder 的 AddressParser 能同时处理显示名和邮箱地址。

为什么中文主题能解码，中文发件人却报错？

常见原因是两处使用了不同的解码路径，或者邮件声明了默认解码器不支持的字符集。检查 CharsetReader 和原始字符集标记，再决定是否接入 x/text。

实际项目可以把“读取邮件头、解码主题、解析地址、记录错误”封装成一个小函数，保留原始字段用于排障，同时只把已经成功解码的值交给业务层。