Word加载项调用displayDialogAsync报错：加载项无法启动但回调返回成功

可能的原因 #

• Office对话框容器的安全限制：即使是同域HTTPS页面，Office的对话框WebView容器（如WebView2）对证书信任的要求比浏览器更严格，自签名的localhost证书若未被系统根信任存储收录，会导致页面加载被拦截。
• 页面脚本异常：对话框页面存在未捕获的JavaScript错误，或者未正确处理Office.js的初始化逻辑（若页面需要和加载项交互），Office会判定加载项启动失败，但displayDialogAsync()仅负责成功创建对话框窗口，不监听后续页面加载状态。
• 页面加载超时：对话框页面资源加载过慢，超出Office默认的加载超时阈值，触发错误提示，但窗口创建已完成，所以回调返回成功。
• Office缓存或组件异常：Office加载项缓存损坏，或者WebView2 Runtime版本过旧/损坏，导致页面渲染异常。

诊断与排查方法 #

• 开启开发者工具调试：在Office中开启加载项调试模式，打开对话框时按F12调出开发者工具，查看控制台的错误日志，定位页面加载或脚本执行的具体问题。
• 验证证书信任：将localhost的HTTPS证书导入到本地计算机的「受信任的根证书颁发机构」存储中，确保Office的WebView容器信任该证书。
• 测试简化页面：将对话框页面替换为极简HTML（仅包含基础结构，无额外脚本或资源），确认是否还触发错误，以此排除页面内容的问题。
• 清除Office加载项缓存：执行命令OfficeAddinCommands.exe clear（适用于Windows版Office），或在Office设置中找到加载项管理选项清除缓存，避免旧缓存干扰。
• 检查WebView2版本：确认Office使用的WebView2 Runtime为最新版本，若版本过旧，手动更新WebView2组件。

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