本地运行的Outlook Add-in在共享邮箱中不显示的问题排查

一、先核对Manifest的核心配置 #

• SupportsSharedFolders位置是否正确：必须放在VersionOverrides->Hosts->Outlook->DesktopFormFactor节点下，不能随意放置。正确示例：

<VersionOverrides xmlns="http://schemas.microsoft.com/office/mailappversionoverrides" xsi:type="VersionOverridesV1_0">
  <Hosts>
    <Host xsi:type="MailHost">
      <DesktopFormFactor>
        <SupportsSharedFolders>true</SupportsSharedFolders>
        <!-- 其他ExtensionPoint等配置 -->
      </DesktopFormFactor>
    </Host>
  </Hosts>
</VersionOverrides>

• 权限与需求集匹配：确认Permissions是ReadWriteMailbox，需求集Requirements里明确指定Mailbox 1.12及以上，且VersionOverrides里的需求配置也要同步更新，避免客户端识别不到。
• 触发规则是否限制了共享邮箱：如果插件有Rule配置（比如ItemIs等），不要添加仅匹配个人邮箱的条件，确保规则对共享邮箱的邮件/日历项也生效。

二、检查Outlook客户端设置 #

• 版本兼容性确认：你的Outlook 2302（内部版本16130.20218）本身支持共享邮箱插件，但要检查是否有组策略禁用了共享邮箱加载项功能。可以通过「文件」->「选项」->「加载项」->「COM加载项」查看是否有相关限制。
• 加载项状态检查：在共享邮箱界面，右键功能区->「自定义功能区」->「查看加载项」，或者进入「设置」->「加载项」，确认你的插件是否存在，状态是否为启用，有没有被标记为禁用或不兼容。

三、本地运行的调试验证 #

• 先验证个人邮箱场景：如果插件在个人邮箱里也不显示，那问题大概率在manifest本身或本地服务器；如果个人邮箱正常，再聚焦共享邮箱的配置。
• 查看本地服务器日志：启动插件的本地服务器后，切换到共享邮箱操作，看是否有请求进入服务器。如果没有请求，说明Outlook没触发加载，大概率是manifest规则不匹配；如果有请求但报错，根据错误信息定位问题。
• 清除Outlook缓存：Outlook可能缓存了旧的manifest配置，关闭Outlook后，删除%LOCALAPPDATA%\Microsoft\Office\16.0\Wef文件夹下的所有内容，重启后重新加载插件试试。

四、其他排查点 #

• 确认共享邮箱类型：必须是Exchange原生的共享邮箱，不能是邮箱别名或仅共享日历的场景，这类非完整共享邮箱可能不支持加载插件。
• SSL证书信任问题：本地运行的插件如果用自签名证书，Outlook可能不信任，导致加载失败。把本地服务器的证书导入到Windows「受信任根证书颁发机构」中再试。

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