
本文介绍使用 email 模块安全、彻底删除邮件中所有非内联附件的正确方法,避免残留空 MIME 部分导致客户端渲染异常(如 Thunderbird/Gmail 显示错乱),并通过 set_payload() 重构消息结构实现真正移除。
本文介绍使用 `email` 模块安全、彻底删除邮件中所有非内联附件的正确方法,避免残留空 mime 部分导致客户端渲染异常(如 thunderbird/gmail 显示错乱),并通过 `set_payload()` 重构消息结构实现真正移除。
在处理归档邮件时,仅调用 part.clear() 是不够的——它只会清空子部分的内容,但保留空的 MIME 子节点(如 text/plain 占位符),从而破坏原始多部分结构。这会导致邮件客户端误解析边界(boundary),引发 HTML 渲染错位、附件图标残留或内嵌图片丢失等问题。
真正有效的做法是重构消息的有效载荷(payload):遍历当前消息的所有直接子部分,筛选出无需保留的部分(例如 content-disposition: attachment 的附件),然后用 set_payload() 替换整个 payload 列表。注意:此操作仅作用于当前层级,需递归处理嵌套 multipart(如 multipart/related 内的附件)以确保完整性。
以下为完整、可运行的解决方案:
from email import policy
from email.parser import BytesParser
from email.message import EmailMessage
def remove_attachments(msg: EmailMessage) -> EmailMessage:
"""递归移除所有 content-disposition=attachment 的部分,保留 inline 和正文"""
if not msg.is_multipart():
return msg
# 获取当前层级所有子部分
payload = msg.get_payload()
if not isinstance(payload, list):
return msg
# 过滤:仅保留无 content-disposition 或明确为 'inline' 的部分
filtered_payload = []
for part in payload:
cd = part.get_content_disposition()
if cd is None or cd == 'inline':
# 对 multipart 子部分递归清理
if part.is_multipart():
remove_attachments(part)
filtered_payload.append(part)
# 用过滤后的新列表替换当前 payload
msg.set_payload(filtered_payload)
return msg
# 使用示例
with open("example.eml", "rb") as fp:
msg = BytesParser(policy=policy.SMTP).parse(fp)
remove_attachments(msg)
# 验证结构已精简(无冗余空部分)
from email.iterators import _structure
print(_structure(msg)) # 输出应不再包含孤立的 image/png / text/plain 占位符✅ 关键要点说明:
立即学习“Python免费学习笔记(深入)”;
- part.clear() ❌ 仅清空内容,不删除节点;msg.set_payload(new_list) ✅ 才能真正移除子部分;
- content-disposition: inline 通常用于 HTML 中
引用的内嵌资源,应保留;
- 必须递归调用(对 part.is_multipart() 的子部分再次清理),否则深层附件(如 multipart/related 中的 PNG)无法被清除;
- 若需保留特定类型附件(如仅删 .txt 而留 .png),可在过滤条件中增强逻辑,例如检查 part.get_filename() 或 part.get_content_type();
- 修改后建议用 msg.as_bytes(policy=policy.SMTP) 保存,确保行尾和编码符合标准,避免新解析问题。
通过该方法,归档邮件将保持语义完整、结构干净,兼容主流邮件客户端,真正实现“移除”而非“隐藏”附件。


















