Office Add-in DialogAPI Close方法终止Web应用及VS调试问题求助

原因分析 #

出现该问题的可能诱因包括：

• Dialog事件监听器未及时移除，关闭时触发了意外的进程关联操作
• 全局变量loginDialog未清理，引发上下文混淆或内存泄漏
• 你使用的Microsoft 365 Apps 2206版本存在Dialog API的进程关联bug
• Visual Studio调试会话错误绑定了任务窗格Web应用与Dialog进程

解决方案 #

1. 修改Dialog事件处理代码，实现安全关闭 #

更新processMessage函数，先移除事件监听器，再异步关闭Dialog并清理全局变量：

export let loginDialog;

export function LoginFallbackInterop() {
    let url = "/azureadauth/login";
    let fullUrl = location.protocol + '//' + location.hostname + (location.port ? ':' + location.port : '') + url;

    Office.context.ui.displayDialogAsync(fullUrl,
        { height: 60, width: 30 }, function (result) {
            loginDialog = result.value;            
            loginDialog.addEventHandler(Microsoft.Office.WebExtension.EventType.DialogMessageReceived, processMessage);
        });
}

export function processMessage(arg) {
    let message = JSON.parse(arg.message);
    
    // 先移除事件监听器，避免后续触发意外回调
    loginDialog.removeEventHandler(Microsoft.Office.WebExtension.EventType.DialogMessageReceived, processMessage);
    
    // 异步执行关闭操作，确保事件处理流程完全完成
    setTimeout(() => {
        if (loginDialog) {
            loginDialog.close();
            // 清空全局变量，避免上下文混淆
            loginDialog = null;
        }
    }, 100);
}

2. 检查Dialog页面的消息发送逻辑 #

确保/azureadauth/login页面仅通过Office.context.ui.messageParent()发送消息，禁止调用window.close()或其他可能影响主窗口的API：

// Dialog页面发送消息的标准写法
Office.context.ui.messageParent(JSON.stringify({/* 你的认证数据 */}));

3. 更新Office到最新版本 #

你当前使用的2206版本存在Dialog API的已知进程关联问题，建议更新至2305及以上版本，修复该bug。

4. 调整Visual Studio调试设置 #

右键BlazorApp.Server项目 → 属性 → 调试：

• 取消勾选停止调试时关闭浏览器
• 确认调试启动方式为Office Add-in，避免直接启动Web应用导致的进程绑定混淆

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