net/mail.ReadMessage 不能直接用于实时邮件网关过滤，因其仅支持完整RFC 5322格式的已落地邮件，无法处理SMTP流中的协议头、不完整数据及畸形报文；网关需先剥离SMTP层、修复MIME头、解码字段、处理编码与multipart结构。
net/mail.ReadMessage 能不能直接用在实时邮件网关过滤中
不能。它只适合处理“已落地”的原始邮件文本，不是为流式、高并发、畸形报文场景设计的。
邮件网关收到的原始 SMTP 流通常混杂协议头（如 220 mx.example.com ESMTP）、空行、DATA 块边界、甚至未完成的连接中断数据；mail.ReadMessage 要求输入是严格 RFC 5322 格式的完整邮件体（头+空行+正文），少一个 \r\n\r\n 或多一个 BOM 就会返回 nil Header 或 panic。
- 真实网关必须先剥离 SMTP 协议层，提取 DATA 部分 —— 通常靠状态机识别
DATA→.边界，再把中间内容喂给mail.ReadMessage - 若上游 SMTP 客户端发的是非标准格式（如换行缩进缺失、字段名后无冒号），
textproto.ReadMIMEHeader（mail.ReadMessage底层依赖）会直接报malformed MIME header line - 网关级预处理必须加一层修复逻辑，比如用
fixBrokenMIMEHeader清洗后再解析，否则每天都会因某台老旧设备发信失败而丢件
From/Subject 字段解码必须手动调用 mime.DecodeWord 吗
是的，而且不能跳过 —— msg.Header.Get("Subject") 返回的就是原始编码串（如 =?UTF-8?B?5L2g5aW9?=），不是乱码，是“没解”。
网关做内容过滤（比如关键词扫描、敏感词拦截）时，如果直接对未解码字段匹配，中文关键词永远扫不到；更糟的是，AddressList("From") 虽内部自动解码 .Name，但 msg.Header.Get("To") 这类纯字符串字段完全不处理。
立即学习“go语言免费学习笔记（深入）”；
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
- 正确做法：对
Subject、CC、Reply-To等纯文本头字段，统一用mime.DecodeWord解码 - 对
To、Cc等复合字段，必须先mail.ParseAddressList拆出*mail.Address，再对每个.Name单独mime.DecodeWord；不能整字段 decode，否则会破坏邮箱地址格式 - 注意：
mime.DecodeWord可能返回错误（如编码损坏），网关应容忍并 fallback 到原始字符串，避免因单封坏邮件阻塞整条流水线
Content-Transfer-Encoding 不处理会导致正文过滤失效
会。网关若直接 io.ReadAll(msg.Body)，拿到的很可能是 base64 或 quoted-printable 的原始字节，不是可读文本 —— 关键词扫描、HTML 提取、附件大小判断全都会错。
尤其当邮件来自 Apple Mail、Outlook 或营销平台时，Content-Transfer-Encoding: base64 是默认行为；不 decode 就等于拿加密数据当明文处理。
- 必须读取
msg.Header.Get("Content-Transfer-Encoding")，常见值有base64、quoted-printable、7bit、8bit -
base64和quoted-printable必须分别用base64.NewDecoder或quotedprintable.NewReader包裹msg.Body后再读 -
7bit/8bit可直读，但要注意Content-Type是否声明了charset（如charset=utf-8），否则中文仍可能乱码
遇到 multipart 邮件时，net/mail 能否递归提取所有正文部分
不能。net/mail 对 multipart/alternative 或 multipart/mixed 完全无感 —— msg.Body 就是一堆带 --boundary 分隔符的原始字节，你看到的“正文不全”，其实是没往下钻。
网关要做正文提取、附件隔离、HTML 转纯文本等操作，必须配合 mime 和 multipart 包手动递归遍历：
- 先用
mime.ParseMediaType(msg.Header.Get("Content-Type"))提取boundary - 用
multipart.NewReader(msg.Body, boundary)创建 reader，循环NextPart() - 每个
part的Header再调一次mime.ParseMediaType判断是text/plain、text/html还是application/pdf - 对
text/*类型 part，仍要检查其自身的Content-Transfer-Encoding并解码
真正容易被忽略的点是：boundary 值带引号（如 boundary="xyz123"），mime.ParseMediaType 已帮你去掉引号，但手写正则提取会漏掉，导致 multipart.NewReader 找不到分隔符、读取卡死。
