为何iOS原生Mail应用无法显示Python smtplib发送的PNG附件？

问题原因 #

• 你使用MIMEMultipart('related')作为邮件根容器，该类型的设计初衷是承载正文内嵌资源（比如HTML中通过Content-ID引用的图片），而非独立附件。iPhone原生Mail对MIME结构的解析逻辑较为严格，会将直接挂载在related容器下的MIMEImage视为正文内嵌资源，但由于你并未在HTML正文中引用该资源的Content-ID，导致它既不会显示在正文里，也不会被识别为独立附件。
• 直接使用MIMEImage时，默认未明确设置Content-Disposition头部为attachment，iPhone Mail可能因此忽略该附件。

解决方案 #

调整MIME结构层级，并给附件添加明确的头部标记，确保兼容所有客户端的同时修复iPhone Mail的问题：

1. 修改根容器类型：最外层使用MIMEMultipart('mixed')，这是邮件客户端普遍支持的、用于同时容纳正文和独立附件的标准MIME结构。
2. 明确附件头部：给MIMEImage添加Content-Disposition头部，明确标记为附件并指定文件名。

修改后的关键代码片段 #

# 最外层使用mixed容器（正文+附件的标准结构）
message = MIMEMultipart('mixed')
message["From"] = self.prepare_from_field(self._sender_name, self._sender_account)
message["Subject"] = self.prepare_email_subject(self._subject_type)
message["To"] = self.prepare_recipients(self._list_of_recipients)
message["Cc"] = self.prepare_recipients(self._list_of_cc)
message["Bcc"] = self.prepare_recipients(self._list_of_bcc)

# 正文部分保留alternative容器，支持纯文本/HTML切换
msgAlternative = MIMEMultipart('alternative')
body = self.prepare_body(self._list_of_texts, self._list_of_disclaimers, self._extra_code, None)
msgText = MIMEText(body, 'html')
msgAlternative.attach(msgText)
# 将正文部分挂载到最外层mixed容器
message.attach(msgAlternative)

# 添加附件的逻辑修改
if self._attachment is not None:
    # 创建图片附件对象，明确指定png子类型
    img_part = MIMEImage(self._attachment, _subtype='png')
    # 明确标记为附件，指定显示的文件名
    img_part.add_header('Content-Disposition', 'attachment', filename='Your png.png')
    # 将附件挂载到最外层mixed容器
    message.attach(img_part)

说明 #

该修改完全符合MIME标准，不会影响Outlook、Gmail等其他客户端的显示效果，同时能让iPhone原生Mail正确识别并显示PNG附件。

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