iOS Mail应用内嵌图片显示为附件的Django解决方法问询

核心问题原因 #

iOS Mail对邮件MIME结构解析严格，当内嵌图片处于multipart/mixed类型结构中时，即便标记了inline，仍会被识别为独立附件。正确的内嵌图片应放在multipart/related结构中，与HTML内容绑定。

解决方案1：重构邮件MIME结构，使用multipart/related #

将HTML内容和内嵌图片放入multipart/related容器，再与纯文本内容组成标准的multipart/alternative结构：

from django.core.mail import EmailMessage
from email.mime.image import MIMEImage
from email.mime.multipart import MIMEMultipart
from email.mime.text import MIMEText

# 准备纯文本内容（符合邮件标准，必填）
plain_content = "纯文本版本的邮件内容"

# 创建包含HTML和图片的related容器
related_part = MIMEMultipart('related')
html_part = MIMEText(html_content, 'html', 'utf-8')
related_part.attach(html_part)

# 添加内嵌Logo
with open(self._get_logo(domain), 'rb') as logo_file:
    logo_image = MIMEImage(logo_file.read())
    logo_image.add_header('Content-Disposition', 'inline')
    logo_image.add_header('Content-ID', '<logo>')
    # 指定图片类型和文件名，辅助iOS Mail识别
    logo_image.add_header('Content-Type', 'image/png', name='logo.png')
    related_part.attach(logo_image)

# 创建外层alternative容器，整合纯文本和related内容
msg = MIMEMultipart('alternative')
msg['Subject'] = subject
msg['From'] = from_address
msg['To'] = ', '.join(to_email)
msg.attach(MIMEText(plain_content, 'plain', 'utf-8'))
msg.attach(related_part)

# 发送邮件
email = EmailMessage(
    subject=subject,
    body='',
    from_email=from_address,
    to=to_email
)
email.attach(msg)
email.send()

解决方案2：修改现有EmailMultiAlternatives的内容类型 #

若想沿用原有代码框架，只需调整邮件的content_subtype为related，同时修正body参数为纯文本内容：

from django.core.mail import EmailMultiAlternatives
from email.mime.image import MIMEImage

# 注意：body必须传纯文本内容，而非HTML
email = EmailMultiAlternatives(
    subject=subject,
    body=plain_content,  # 替换为你的纯文本内容
    from_email=from_address,
    to=to_email
)
email.attach_alternative(html_content, "text/html")

# 将邮件内容类型改为related，绑定HTML和内嵌图片
email.content_subtype = 'related'

with open(self._get_logo(domain), 'rb') as logo_file:
    logo = MIMEImage(logo_file.read())
    logo.add_header('Content-Disposition', 'inline')
    logo.add_header('Content-ID', '<logo>')
    # 补充图片类型和文件名
    logo.add_header('Content-Type', 'image/png', name='logo.png')
    email.attach(logo)

email.send()

关键注意事项 #

• 纯文本内容不可缺：原代码中EmailMultiAlternatives的body参数误用了HTML内容，会导致邮件结构异常，必须替换为纯文本版本。
• 明确图片属性：添加Content-Type的name属性，帮助iOS Mail正确识别图片类型，避免误判为附件。
• Content-ID需匹配：确保HTML中cid:logo与MIMEImage的Content-ID（带尖括号）完全一致。

内容的提问来源于stack exchange，提问作者Philipp S.