Excel 16.13版本Office JS Dialog重复打开报错问题求助

我之前碰到过完全一样的情况，这确实是Excel 16.13版本独有的一个状态同步bug——当你通过代码关闭对话框后，Office JS的内部状态没有及时更新，导致它误以为对话框还处于打开状态，进而抛出-12007这个错误。

问题复现场景 #

你使用Office JS的这个函数打开对话框：

Office.context.ui.displayDialogAsync(startAddress, options, callback)

在调用对话框的close()方法或通过messageParent触发关闭后，再次调用displayDialogAsync就会弹出错误：

错误代码 - 12007。任务窗格已打开一个对话框，任务窗格加载项一次只能打开一个对话框。

这个问题仅出现在Microsoft Excel 16.13，旧版本不存在这个状态不同步的问题。

解决方案 #

要解决这个问题，核心是手动管理对话框的引用，并在确认对话框关闭后显式清理引用，同时给Office JS足够的时间更新内部状态。

1. 保存对话框的全局引用
   打开对话框时，务必把返回的Dialog对象存到全局变量中，方便后续跟踪状态：

let currentDialog = null;

function openDialog() {
  Office.context.ui.displayDialogAsync(
    "/dialog.html",
    { height: 50, width: 50 },
    function (asyncResult) {
      if (asyncResult.status === Office.AsyncResultStatus.Succeeded) {
        currentDialog = asyncResult.value;
        // 监听对话框的关闭事件
        currentDialog.addEventHandler(Office.EventType.DialogEventReceived, onDialogClosed);
      }
    }
  );
}

2. 关闭时清理引用并延迟同步状态
   在对话框关闭的事件处理函数里，不仅要清空引用，还要加一段延迟等待，确保Office JS的内部状态完成更新（这是针对16.13版本的关键操作）：

function onDialogClosed(event) {
  // 移除事件监听并清空对话框引用
  if (currentDialog) {
    currentDialog.removeEventHandler(Office.EventType.DialogEventReceived, onDialogClosed);
    currentDialog = null;
  }
  // 给Excel 16.13足够的状态同步时间
  setTimeout(() => {
    // 这里可以放置后续打开新对话框的逻辑，或者标记对话框已完全关闭
  }, 300);
}

3. 添加重复调用的防御性检查
   在调用displayDialogAsync之前，先检查currentDialog是否为null，避免无效的重复触发：

function openDialogSafely() {
  if (!currentDialog) {
    openDialog();
  }
}

额外说明 #

这个bug在Excel 16.14及后续版本已经被官方修复了，如果用户可以升级Excel版本，升级是最彻底的解决办法。但如果必须兼容16.13版本，上面的手动管理引用+延迟等待的方案可以有效规避这个问题。

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