Windows端Outlook桌面版SmartAlerts（launchevent.js）加载触发异常

问题场景 #

基于纯TypeScript、Yeoman模板+Webpack开发的Outlook插件，阅读窗格功能全平台正常，但撰写模式下依赖launchevent.js的SmartAlerts仅在Windows桌面端异常：

• 新建邮件时插件加载极慢，OnNewMessageCompose事件无触发
• 发送邮件时报错“插件无法处理消息”，API请求无法到达服务器
• 旧版commands.html的itemSend处理无问题，仅升级SmartAlerts后出现该情况

已完成的排查（供参考） #

• 多版本ES转译验证，ES兼容性无问题
• 已通过Office.actions.associate关联事件处理函数，清单事件注册正确
• 简化launchevent.js至基础代码仍无法解决
• 移除平台判断逻辑后问题依旧
• 添加.well-known/microsoft-officeaddins-allowed.json解决了launchevent.js资源访问被拒问题，但仍有“无法访问插件”事件日志
• Fiddler显示所有资源请求均返回200 OK，但事件未触发

针对性解决思路 #

1. 检查Webpack打包对launchevent.js的处理 #

Windows桌面端Outlook对脚本加载时机和打包结构敏感度更高：

• 确保launchevent.js未被Webpack打包混淆，通过Webpack配置的externals字段排除该文件，保持独立加载
• 验证launchevent.js的加载顺序：必须在Office.js之后、插件业务脚本之前同步加载，避免依赖时序问题
• 排查打包后的脚本是否存在异步加载延迟，尝试将launchevent.js改为静态同步引入

2. 验证SmartAlerts事件关联细节 #

• 确认Office.actions.associate的调用时机：必须在Office.initialize完成后立即执行，不能被异步逻辑包裹（Windows桌面端对事件绑定时机要求严格）
• 检查事件处理函数的返回值：itemSend事件的处理函数需返回合规的Promise，且不能存在未捕获异常，否则会触发“无法处理消息”报错
• 核对清单配置：ExtensionPoint的Type需设为Event，Event节点的Type和FunctionName需与代码完全对应，ExecuteFunction的SourceLocation需指向正确的launchevent.js路径

3. 排查Windows桌面端特殊限制 #

• 检查插件HTTPS证书：Windows桌面端Outlook对证书校验更严格，需确保证书由可信CA颁发，且域名与插件部署域名完全匹配（避免自签证书或域名不匹配导致的静默加载失败）
• 验证launchevent.js的MIME类型：服务器需返回application/javascript类型，避免Windows端浏览器内核解析异常
• 查看Outlook桌面端插件日志：通过%LOCALAPPDATA%\Microsoft\Office\16.0\Wef\Logs路径获取详细日志，排查未捕获脚本错误或权限限制

4. 尝试调整launchevent.js版本 #

• 使用微软官方提供的最新版launchevent.js，确保与当前使用的Office.js版本兼容
• 临时替换为官方SmartAlerts示例中的launchevent.js代码，逐步对比排查代码差异

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