Python处理邮件附件的核心是理解MIME分层结构:发送时用MIMEMultipart容器组装正文与MIMEApplication封装的附件;解析时需walk遍历并依Content-Disposition和编码解码附件名,同时校验类型与大小确保安全。
Python 发送带附件的邮件、解析收到的邮件(尤其是含附件的),核心在于正确构造 MIMEMultipart 消息结构,以及准确识别和提取 MIME 部分的内容类型与编码方式。关键不是堆砌代码,而是理解邮件的“分层包装”逻辑。
纯文本邮件用 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 对象,别发错对象收到的邮件是 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(dec
ode=True)(自动解码 base64 / quoted-printable),返回 bytes,再按需保存为文件image/* 类型可能是内嵌图片(Content-ID 引用),不一定是附件,需结合 Content-Disposition 判断邮件头里的中文文件名(如 filename="报告.pdf")常被编码为 =?UTF-8?B?5byg5LiJ55CG5ZGYLnBkZg==?= 格式。直接读 .get_filename() 可能返回 None 或乱码。必须用 email.header.decode_header() 手动解码。
立即学习“Python免费学习笔记(深入)”;
part.get('Content-Disposition', '')
filename=.*? 后面的值(注意单/双引号和空格)decode_header() → 得到 (bytes, charset) 元组 → 用对应编码 decode 成 strstr(..., encoding='latin-1') 容错,避免异常邮件附件是常见攻击入口。解析时不能盲目保存或执行:
Content-Type 是否匹配扩展名(如 application/pdf 对应 .pdf),警惕 text/plain 声称是 PDF 的伪装len(payload_bytes) ),防止内存爆炸
os.path.basename() 过滤,禁用 ../ 路径遍历不复杂但容易忽略。