Outlook插件Smart alerts在Legacy版本失效问题排查求助

1. 版本兼容性与要求集检查 #

• 确认Outlook Legacy 2401版本对onMessageSend事件的支持性：该事件属于Mailbox要求集1.13及以上，部分Legacy分支版本可能对高版本要求集支持不全。检查插件清单中的<Requirements>节点是否声明了正确的版本，示例：

<Requirements>
  <Sets>
    <Set Name="Mailbox" MinVersion="1.13"/>
  </Sets>
</Requirements>

• 若功能允许，可尝试将要求集版本降至1.12，测试Legacy版本是否能正常加载。

2. 清单配置的Legacy适配验证 #

• 检查权限声明：Legacy版本对权限校验更严格，确保已声明足够权限，比如：

<Permissions>ReadWriteMailbox</Permissions>

• 确认onMessageSend的规则配置是否符合Legacy格式要求，避免使用仅现代UI支持的条件属性。
• 检查<Runtimes>节点是否指定了兼容Legacy的运行时配置，部分Legacy环境需要明确声明运行时类型。

3. 运行时内核兼容性排查 #

• Legacy版本默认使用IE内核，而现代UI采用Edge WebView2，插件代码若使用了仅WebView2支持的API（如ES6+语法、Fetch API的特殊参数），会导致在Legacy中运行报错。
• 开启Legacy的调试工具：右键插件选择「检查元素」打开IE调试控制台，查看是否有JS语法错误、未定义变量等报错信息。

4. 日志定位具体故障原因 #

• 在Outlook Legacy中启用日志：
  1. 点击「文件」>「选项」>「高级」
  2. 找到「开发人员」板块，勾选「启用日志记录以进行故障排除」
  3. 重现插件失效操作后，前往%LOCALAPPDATA%\Microsoft\Office\16.0\Wef\Logs目录查看日志，搜索Addin is unavailable相关条目，定位具体失败原因（如清单解析错误、加载超时、权限不足等）

5. 部署方式校验 #

• 若为商店部署，确认Legacy版本能正确拉取插件最新版本；若为侧加载，检查清单文件路径是否符合Legacy要求（比如是否支持网络路径，或是否需要本地绝对路径）

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