Python发送邮件：iOS原生Mail应用附件显示位置异常求助

问题根源 #

你给附件添加的Content-ID和X-Attachment-Id头会让iOS Mail误将普通附件识别为内嵌图片，导致它被提前到正文区域显示甚至重叠。加上iOS对MIME结构的解析逻辑更严格，才出现了和Gmail/Outlook不一致的表现。

修复方案 #

1. 移除内嵌图片专属头信息 #

X-Attachment-Id和Content-ID是给邮件正文中引用的内嵌图片用的，普通附件不需要这两个头，直接删除即可。

2. 明确附件的Content-Disposition属性 #

确保附件的Content-Disposition严格设为attachment，避免iOS混淆内嵌图和普通附件的类型。

3. 优化后的完整代码 #

message = MIMEMultipart('mixed')
message["From"] = "XXX"
message["Subject"] = "XXX"
message["To"] = "XXX"
message["Cc"] = "XXX"
message["Bcc"] = "XXX"

# 构造HTML正文容器
msgAlternative = MIMEMultipart('alternative')
body = """<div dir="ltr">test</div>"""
msgText = MIMEText(body, 'html', 'utf-8')
msgAlternative.attach(msgText)
message.attach(msgAlternative)

# 添加附件
if self._attachment is not None:
    # 构造图片附件并指定文件名
    image = MIMEImage(self._attachment, name='PNGfile.png')
    # 仅保留附件必需的头信息
    image.add_header('Content-Disposition', 'attachment', filename='PNGfile.png')
    # 移除以下两行内嵌图片专属的头
    # image.add_header('X-Attachment-Id', 'ID')
    # image.add_header('Content-ID', 'ID')
    message.attach(image)

# 生成最终邮件字符串
text = message.as_string()

4. 备选优化方案（若上述方法仍无效） #

如果iOS Mail还是识别异常，可以用MIMEBase手动构造附件，更精准控制Content-Type：

import mimetypes
from email import encoders

if self._attachment is not None:
    # 自动识别文件类型
    content_type, encoding = mimetypes.guess_type('PNGfile.png')
    main_type, sub_type = content_type.split('/', 1)
    
    image = MIMEBase(main_type, sub_type)
    image.set_payload(self._attachment)
    encoders.encode_base64(image)
    
    image.add_header('Content-Disposition', 'attachment', filename='PNGfile.png')
    message.attach(image)

原理说明 #

移除内嵌图片头后，iOS Mail会正确识别该文件为普通附件，按照你代码中「先正文、后附件」的添加顺序，将附件显示在邮件末尾，不会再和正文重叠。

内容的提问来源于stack exchange，提问作者MartinHN