Outlook不展示API调用发送邮件内PNG附件问题咨询

差异根因分析 #

• inline附件未被正文引用的处理逻辑差异
  你提供的MIME结构里，PNG图片的Content-Disposition被设置为inline，且对应的Content-ID: <Capture%202.PNG>没有在HTML正文中通过<img src="cid:Capture%202.PNG">的形式引用。Gmail的解析逻辑相对宽松，未被引用的inline附件也会在附件栏展示；但Outlook严格遵循MIME语义，未被正文引用的inline附件会被判定为冗余内容，既不插入正文也不在附件栏展示，直接隐藏。
• Content-ID编码兼容性差异
  你使用的Content-ID中包含URL编码的空格%20，部分版本的Outlook对Content-ID中的特殊字符、URL编码的解析逻辑和Gmail不同，就算后续补充了正文引用，也可能识别不到对应资源，进一步导致附件被隐藏。
• MIME结构严格性判定差异
  你邮件的外层是multipart/mixed结构，所有内容都嵌套在内层的multipart/related结构中。Outlook对multipart/related包内的非引用资源过滤策略比Gmail严格，Gmail会将该结构下所有可识别文件都列为附件，Outlook只会展示被正文引用、或Content-Disposition明确设置为attachment的文件。

关于是否为API/服务器故障的说明 #

该问题不属于服务器或API调用故障，你提供的邮件头显示SPF、DKIM、DMARC校验全部通过，邮件已经完整送达目标邮箱，只是两家邮箱客户端的解析规则不同导致的展示差异，问题根因是API构建MIME结构时的参数设置不符合Outlook的解析规则。

修复方案 #

• 若你需要该图片作为普通附件展示，直接将Content-Disposition的取值从inline修改为attachment即可，Outlook会直接在附件栏展示该文件
• 若你需要该图片内嵌到正文显示，在HTML正文中补充对应CID的<img>标签引用，同时建议将Content-ID中的%20替换为直接空格，或删除文件名中的空格避免编码兼容问题
• 也可以将图片资源从multipart/related结构中移出，放在外层multipart/mixed下作为独立的附件节点，两家邮箱都可以正常识别展示

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