Python处理邮件附件的核心是理解MIME分层结构:发送时用MIMEMultipart容器组装正文与MIMEApplication封装的附件;解析时需walk遍历并依Content-Disposition和编码解码附件名,同时校验类型与大小确保安全。

Python 发送带附件的邮件、解析收到的邮件(尤其是含附件的),核心在于正确构造 MIMEMultipart 消息结构,以及准确识别和提取 MIME 部分的内容类型与编码方式。关键不是堆砌代码,而是理解邮件的“分层包装”逻辑。
发送带附件的邮件:用 MIMEMultipart 分层组装
纯文本邮件用 MIMEText 就够了,但一旦加附件,就必须用 MIMEMultipart 作为容器,把正文和附件作为独立的“部分”塞进去。常见错误是直接 attach 文件内容字符串——必须用 MIMEBase 或其子类(如 MIMEApplication)封装二进制数据,并设置正确的 Content-Type 和 Content-Transfer-Encoding。
- 先创建
MIMEMultipart()实例,设为'mixed'类型(默认,适合正文+附件组合) - 用
MIMEText(正文, 'plain', 'utf-8')构造正文部分,再.attach()进去 - 对每个附件:读取为
bytes→ 用MIMEApplication(数据, _subtype='pdf')(或octet-stream)封装 → 设置add_header('Content-Disposition', 'attachment', filename=文件名) - 最后用
smtplib发送整个MIMEMultipart对象,别发错对象
解析带附件的邮件:递归遍历 MIME 树
收到的邮件是 email.message.Message 对象,它可能嵌套多层(比如 HTML 正文 + 图片内嵌 + ZIP 附件)。不能只看 .get_payload(),必须用 .is_multipart() 判断是否为容器,再用 .walk() 或递归遍历所有部分。
- 调用
message.walk()获取所有 MIME 部分(包括嵌套的),逐个检查.get_content_maintype()和.get_content_subtype() - 正文通常为
text/plain或text/html;附件是application/octet-stream、application/pdf等,且.get('Content-Disposition', '').startswith('attachment') - 提取附件内容:用
part.get_payload(decode=True)(自动解码 base64 / quoted-printable),返回bytes,再按需保存为文件 - 注意:HTML 邮件里
image/*类型可能是内嵌图片(Content-ID引用),不一定是附件,需结合Content-Disposition判断
处理中文附件名与编码问题
邮件头里的中文文件名(如 filename="报告.pdf")常被编码为 =?UTF-8?B?5byg5LiJ55CG5ZGYLnBkZg==?= 格式。直接读 .get_filename() 可能返回 None 或乱码。必须用 email.header.decode_header() 手动解码。
立即学习“Python免费学习笔记(深入)”;
- 获取原始 header 值:
part.get('Content-Disposition', '') - 用正则提取
filename=.*?后面的值(注意单/双引号和空格) - 传给
decode_header()→ 得到 (bytes, charset) 元组 → 用对应编码 decode 成 str - 若无 charset(如 ASCII),用
str(..., encoding='latin-1')容错,避免异常
安全提醒:附件处理前务必校验
邮件附件是常见攻击入口。解析时不能盲目保存或执行:
- 检查
Content-Type是否匹配扩展名(如application/pdf对应.pdf),警惕text/plain声称是 PDF 的伪装 - 限制附件大小(如
len(payload_bytes) ),防止内存爆炸 - 保存路径使用
os.path.basename()过滤,禁用../路径遍历 - 敏感环境建议用沙箱或临时目录解压 ZIP 类附件,再扫描内容
不复杂但容易忽略。










