Outlook Web Add-In创建模态窗口失败求助

• 补全错误回调，抓取具体问题
  你当前的代码未添加回调函数，无法定位是权限、域名还是参数导致的失败。修改为带回调的版本，直接通过控制台查看错误信息：

  Office.context.ui.displayDialogAsync('https://www.contoso.com/myDialog.html', {height: 60, width: 50}, function(res) {
    if (res.status === Office.AsyncResultStatus.Failed) {
      console.error('弹窗失败原因:', res.error.message);
    } else {
      // 成功打开后可监听弹窗关闭事件
      res.value.addEventHandler(Office.EventType.DialogEventReceived, (e) => console.log('弹窗事件:', e));
    }
  });
  

• 检查manifest配置，这是核心环节

  • 必须在manifest.xml中将对话框的域名添加到<AppDomains>，否则会被Office安全机制阻止：

    <AppDomains>
      <AppDomain>https://www.contoso.com</AppDomain>
    </AppDomains>
    

  • 权限至少设置为ReadWriteMailbox，低权限可能无法触发弹窗：

    <Permissions>ReadWriteMailbox</Permissions>
    

• 确认调用时机，不能早于Office初始化
  所有调用Office API的代码都要等待Office.initialize完成后执行，示例：

  Office.initialize = function(reason) {
    // 绑定按钮点击事件或直接执行弹窗逻辑
    document.getElementById('openDialogBtn').addEventListener('click', openDialog);
  };
  
  function openDialog() {
    // 弹窗代码放在这里
  }
  

• 调整参数合理性
  你设置的height:30, width:20是百分比数值，过小可能导致窗口显示在角落难以察觉，建议改为height:60, width:50（取值范围为10-100之间的整数）。

• 验证对话框页面有效性

  • 必须使用HTTPS协议，HTTP页面在Outlook Web中会被拦截
  • 确保页面能正常访问，无404或资源加载失败情况

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