使用共享运行时的Excel加载项：displayDialogAsync触发未处理异常

核心原因推测 #

这个错误源于共享运行时环境下，弹窗页面的Office.js初始化流程与独立运行时存在差异，导致内部register方法执行时依赖的对象尚未完成初始化，属于竞态条件问题，大概率是Office.js在共享运行时场景下的加载顺序bug，但可以通过编码手段规避。

具体解决方法 #

1. 强制弹窗页面等待Office.js完全就绪 #

在弹窗的HTML页面中，确保所有依赖Office API的代码都包裹在Office.onReady()回调中，避免提前执行触发未定义对象的错误：

Office.onReady().then(() => {
  // 这里放置弹窗的核心业务逻辑，包括任何需要调用Office API的代码
  // 比如原本直接执行的register相关操作，移到此处
});

如果使用的是旧版Office.js，也可以用Office.initialize事件：

Office.initialize = function(reason) {
  // 执行弹窗逻辑
};

2. 检查共享运行时的Manifest配置 #

确认Manifest中的<Runtime>节点配置正确，确保共享运行时的资源路径和上下文加载无误：

<Runtime resid="TaskPane.Url">
  <Override type="javascript" resid="SharedRuntime.Url"/>
</Runtime>

注意resid指向的页面必须是能正确加载Office.js的入口页面，避免路径错误导致的加载异常。

3. 升级Office.js版本 #

尝试将引用的Office.js从lib/1升级到更高版本（比如lib/1.1或最新稳定版），微软可能已经修复了共享运行时与弹窗交互的竞态问题：

<script src="https://appsforoffice.microsoft.com/lib/1.1/hosted/office.js"></script>

4. 添加全局错误捕获（临时规避用户体验问题） #

如果上述方法仍有偶发错误，可以在弹窗页面添加全局错误监听，拦截特定错误并阻止其显示给用户：

window.addEventListener('error', (e) => {
  if (e.message.includes("Cannot read properties of undefined (reading 'register')")) {
    e.preventDefault();
    // 可选：记录错误日志用于排查
  }
});

关于appsforoffice库的问题判断 #

这个错误确实指向Office.js库内部的逻辑，属于特定环境（共享运行时）下的加载竞态bug，但并非无法解决——通过规范初始化流程和版本升级，基本可以消除该问题。微软的Office.js团队会持续修复这类场景问题，建议关注官方更新日志。

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