IE与Edge中Outlook插件认证对话框出现office.js加载警告的问题

我之前调试Office插件时也碰到过类似的兼容性问题，结合官方文档和实际踩坑经验，给你梳理下问题根源和可行的解决办法：

问题原因分析 #

IE11和Edge的保护模式是导致问题的核心：

• 保护模式会为不同安全级别的页面创建独立的沙箱进程，即便重定向页面和插件同域，从外部OAuth登录页跳转回来时，对话框的上下文可能仍被锁定在外部域的沙箱中，导致office.js无法正确关联到Office客户端的运行环境，最终出现Office.context.ui为null、提示"office.js is loaded outside of office client"的情况。
• Edge的保护模式是强制启用的，无法手动关闭；而IE中关闭保护模式后沙箱限制解除，问题就消失了。部分实例能正常运行，是因为沙箱的上下文关联存在随机性（比如登录页的安全区域识别偶然符合要求）。

解决方案 #

1. 优化重定向页面的office.js初始化逻辑 #

当前代码依赖Office.initialize触发后直接调用messageParent，但在保护模式下，office.js的初始化可能延迟或失败。我们可以增加重试机制和对象存在性检查：

<script type="text/javascript" src="https://appsforoffice.microsoft.com/lib/1/hosted/office.js"></script>
<script type="text/javascript">
    // 封装发送令牌的函数，增加重试逻辑
    function sendTokenToParent() {
        // 确保Office对象及所需属性存在
        if (typeof Office !== 'undefined' && Office.context && Office.context.ui) {
            Office.context.ui.messageParent(window.location.hash);
        } else {
            // 最多重试5次，每次间隔100ms
            const retryCount = window.retryCount || 0;
            if (retryCount < 5) {
                window.retryCount = retryCount + 1;
                setTimeout(sendTokenToParent, 100);
            }
        }
    }

    // 监听Office初始化事件
    Office.initialize = function () {
        sendTokenToParent();
    };

    // 兜底：如果Office.initialize未触发，主动启动重试
    setTimeout(sendTokenToParent, 500);
</script>

这种方式能应对初始化延迟的情况，避免因为office.js加载慢导致的调用失败。

2. 开启对话框的iframe模式 #

调用displayDialogAsync时，添加displayInIframe: true参数，让对话框在iframe中运行，这样能更好地和插件的上下文保持一致，减少沙箱隔离的影响：

let authDialog;
Office.context.ui.displayDialogAsync(yourAuthUrl, {
    height: 60,
    width: 60,
    displayInIframe: true // 关键参数
}, function (result) {
    if (result.status === Office.AsyncResultStatus.Succeeded) {
        authDialog = result.value;
        // 监听对话框的消息回调
        authDialog.addEventHandler(Office.EventType.DialogMessageReceived, function (args) {
            // 处理收到的令牌
            const token = args.message;
            // 关闭对话框
            authDialog.close();
        });
    }
});

注意：这个参数要求Outlook 2016及以上版本支持，需要确保你的插件清单兼容对应的Office版本。

3. 将插件域名加入IE/Edge的可信站点 #

虽然Edge不能关闭保护模式，但把插件的域名添加到可信站点列表，可以降低保护模式下的安全限制：

• 打开IE的「Internet选项」→「安全」→「可信站点」→「站点」
• 添加你的插件域名（如果是http域名，记得去掉“对该区域中的所有站点要求服务器验证(https:)”的勾选）
• Edge会继承IE的可信站点设置，这样对话框的上下文会被识别为可信区域，减少沙箱隔离的影响。

4. 调整OAuth回调的令牌传递方式 #

如果你的OAuth服务支持，可以尝试将令牌通过查询参数而非hash传递，部分情况下能绕过沙箱对hash的解析限制。不过这个需要后端配合调整OAuth的回调配置，属于可选方案。

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