Outlook桌面端加载项Manifest配置的IconUrl图标无法显示

Outlook加载项属于官方文档定义的邮件应用范畴，使用64x64像素作为IconUrl、128x128作为高分辨率图的尺寸配置符合Manifest验证规则，网页端正常显示、桌面端加载失败可按以下优先级排查修复：

• 检查图标资源的响应规则
  桌面端Outlook对远程资源的校验逻辑比网页端严格得多：
  • 必须确认图标资源返回的Content-Type与实际格式匹配，PNG文件对应image/png，禁止返回application/octet-stream等非图片MIME类型
  • 图标资源的响应头不能设置no-cache、no-store缓存策略，桌面端会直接拦截不允许缓存的远程资源，建议设置Cache-Control: public, max-age=604800（7天缓存）
  • 托管图标的服务器必须启用TLS 1.2及以上协议，使用公开可信的SSL证书，不支持自签名证书、证书链不完整的资源
  • 图标资源必须支持匿名访问，桌面端拉取图标时不会携带加载项页面的登录态，任何需要身份跳转、内网权限校验的资源都会被拦截
• 检查图标文件本身的兼容性
  分辨率达标不代表可以正常渲染：
  • 不要使用带索引透明的PNG文件，Outlook 2016/2019等批量授权版本无法正常解析这类格式，建议导出为标准PNG-24格式
  • 不要使用SVG格式作为IconUrl，旧版桌面端Outlook完全不支持SVG格式的加载项图标，必须使用PNG等位图格式
  • 导出图标时删除所有非必要的EXIF、编辑软件元数据，避免触发桌面端的文件解析异常
• 检查Manifest路径解析逻辑
  当前配置使用了~remoteAppUrl占位符，需要确认：
  • 占位符解析后生成的图标绝对路径，在Outlook桌面端所在设备的系统浏览器中可以直接打开，不存在路径404、跳转问题
  • 路径中不要包含中文、空格、特殊转义字符，旧版Outlook对非ASCII路径的解析存在已知bug
• 清理本地损坏的加载项缓存
  以上配置都确认无误的情况下，基本是本地缓存损坏导致：
  1. 完全退出Outlook，包括后台驻留的相关进程
  2. 打开资源管理器，进入路径%LOCALAPPDATA%\Microsoft\Office\16.0\Wef\，删除该目录下所有文件和文件夹
  3. 重启Outlook后重新旁加载加载项，图标会重新拉取渲染

排查时可以直接查看桌面端加载项日志定位具体错误：打开Outlook「文件-选项-信任中心-信任中心设置-加载项」，找到加载项运行日志入口，日志会明确记录图标加载失败的具体原因（如证书错误、MIME不匹配、资源404等）。

附问题相关参考信息：

• 网页端正常显示效果截图：
• 桌面端异常效果截图：
• 问题对应的Manifest配置片段：

<!-- The display name of your add-in. Used on the store and various places of the Office UI such as the add-ins dialog. -->
  <DisplayName DefaultValue="TeamsAssist Help" />
  <Description DefaultValue="TeamsAssist Notifications Help"/>
  <IconUrl DefaultValue="~remoteAppUrl/Images/TeamsAssistLogo64x64.png"/>
  <HighResolutionIconUrl DefaultValue="~remoteAppUrl/Images/TeamsAssistLogo128x128.png"/>

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