为何Outlook加载项从静态网站侧载时onMessageSendHandler静默失败？

针对你遇到的Outlook加载项部署到Azure静态网站后onMessageSendHandler失效的问题，结合本地正常、部署异常的差异，主要排查以下几个方向：

1. 权限配置不匹配 #

• 检查加载项manifest文件的<Permissions>节点：修改收件人列表的onMessageSendHandler需要至少ReadWriteMailbox权限，而主题设置仅需ReadWriteItem权限。如果manifest仅配置了ReadWriteItem，部署后会因权限不足导致收件人修改失败。
• 确认<DesktopFormFactor>下的<ExtensionPoint>配置：ItemSend事件的FunctionName必须和代码中的函数名完全一致，避免拼写或大小写错误。

2. HTTPS与内容安全策略（CSP）限制 #

• 确保manifest中所有资源URL（如<SourceLocation>）都使用HTTPS协议：Outlook加载项要求远程资源必须走HTTPS，本地侧载的HTTP环境是例外，Azure静态网站默认支持HTTPS，需同步更新manifest中的地址。
• 检查网站CSP配置：如果Azure静态网站的CSP设置过于严格，阻止了office.js的加载或API调用，会导致onMessageSendHandler中的Office.js接口无法执行。需确保CSP允许https://appsforoffice.microsoft.com等Office相关域名的资源访问。

3. 部署文件完整性与路径错误 #

• 确认部署到Azure的文件完整：本地开发时处理ItemSend事件的脚本文件是否全部上传，有没有遗漏核心逻辑文件。
• 核对相对路径引用：本地开发的路径在部署后可能因网站根目录结构变化失效，导致onMessageSendHandler代码未被正确加载。比如脚本引用路径需适配Azure静态网站的实际目录结构。

4. Outlook客户端缓存问题 #

• Outlook会缓存加载项的manifest和资源文件，部署新版本后可能未及时更新。可尝试清除缓存：
  • 关闭Outlook，打开%LOCALAPPDATA%\Microsoft\Office\16.0\Wef\目录，删除所有子文件夹
  • 重新打开Outlook并重新侧载加载项

5. 权限授予流程未完成 #

• 本地侧载时Outlook可能自动授予全部权限，但部署后侧载时，用户可能未完成权限同意流程。重新侧载加载项，在弹出的权限请求窗口中确认授予所有必要权限。

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