Python 3.5内嵌JPG邮件兼容性问题：仅Thunderbird可正常读取

阿华AIGC实验室

2026-5-19

Python3.5 内嵌图片邮件多客户端兼容问题解决方案

我之前也碰到过一模一样的情况——用官方示例写的内嵌图片邮件，Thunderbird能正常显示，但Apple Mail和Gmail网页版就是不加载图片。后来排查发现，核心问题出在MIME结构、Content-ID格式和资源标记方式上，这些细节Thunderbird容错性高，但其他客户端要求更严格。

常见问题点及修复步骤

Content-ID格式错误：必须用<>包裹唯一标识（比如<image_unique_id@your_domain>），很多新手容易漏掉尖括号，导致客户端无法关联HTML里的cid:引用。
MIME类型选错：要使用multipart/related而非multipart/mixed，前者专门用于关联HTML和内嵌资源，后者是普通多附件邮件的类型，混用会导致部分客户端把内嵌图片识别成普通附件。
编码和资源标记缺失：确保图片的Content-Transfer-Encoding设为base64（最兼容的编码），同时通过Content-Disposition: inline明确标记为内嵌资源，而非下载附件。

修正后的完整代码示例

import smtplib
from email.mime.multipart import MIMEMultipart
from email.mime.text import MIMEText
from email.mime.image import MIMEImage

# 初始化邮件，指定为related类型
msg = MIMEMultipart('related')
msg['Subject'] = '内嵌图片测试邮件'
msg['From'] = '你的邮箱地址'
msg['To'] = '收件人邮箱地址'

# 构建HTML内容，注意cid引用要和Content-ID完全匹配（包括尖括号）
html_content = """
<html>
  <body>
    <p>这是一张内嵌在邮件里的图片：</p>
    <img src="cid:image_test_001">
  </body>
</html>
"""
msg.attach(MIMEText(html_content, 'html', 'utf-8'))

# 读取并添加内嵌图片
with open('你的图片路径.png', 'rb') as img_file:
    mime_img = MIMEImage(img_file.read())
    # 设置唯一的Content-ID，必须带尖括号
    mime_img.add_header('Content-ID', '<image_test_001>')
    # 标记为内嵌资源，同时指定文件名提升兼容性
    mime_img.add_header('Content-Disposition', 'inline', filename='测试图片.png')
    # 指定编码为base64
    mime_img.add_header('Content-Transfer-Encoding', 'base64')
    msg.attach(mime_img)

# 发送邮件（根据你的SMTP服务调整参数）
with smtplib.SMTP('smtp.你的邮箱服务商.com', 587) as smtp_server:
    smtp_server.starttls()
    smtp_server.login('你的邮箱账号', '授权码/密码')
    smtp_server.send_message(msg)