WebView1/旧版Edge下Outlook加载项无法正常退出及启动问题求助

核心问题分析 #

你的加载项因要求集设置为Mailbox 1.9，导致依赖WebView1/旧Edge的旧版Outlook无法完成加载流程，浏览器检测代码根本没机会执行，最终卡在“加载项正在加载”状态。要实现优雅退出，关键是先让加载项能启动，再做兼容性判断。

具体解决方案 #

1. 降低要求集版本，确保加载项能初始化

将Requirements中的MinVersion降低到旧版Outlook支持的最低值（比如1.1），让加载项至少能加载任务窗格：

<Requirements>
    <Sets>
        <Set Name="Mailbox" MinVersion="1.1" />
    </Sets>
</Requirements>

这样旧版环境下加载项不会直接卡死，能进入任务窗格的初始化流程。

2. 用Office.js特性检测替代User-Agent判断

放弃不可靠的navigator.userAgent检测，直接判断目标API是否存在：

// 初始化Office.js后执行
Office.initialize = function(reason) {
    // 检测DialogApi是否支持
    if (Office.context.ui && typeof Office.context.ui.displayDialogAsync === 'function') {
        // 支持对话框，打开正常业务页面
        openDialog(e, `${getUrl()}?mode=attach`, "attach");
    } else {
        // 不支持，在任务窗格显示优雅提示
        showUnsupportedMessage();
    }
};

function showUnsupportedMessage() {
    const container = document.createElement('div');
    container.style.padding = '2rem';
    container.style.textAlign = 'center';
    container.innerHTML = `
        <h3>当前环境不支持该加载项</h3>
        <p>请使用新版Outlook客户端或升级浏览器以使用全部功能</p>
    `;
    document.body.appendChild(container);
}

3. 添加加载超时兜底逻辑

如果旧版环境下Office.js加载失败，直接显示提示：

<!-- 在页面中添加隐藏的提示容器 -->
<div id="load-fallback" style="display:none; padding:2rem; text-align:center;">
    <h3>加载失败</h3>
    <p>你的Outlook版本或浏览器不兼容该加载项，请尝试升级后重试</p>
</div>

<script>
    // 设置5秒超时，若Office未初始化则显示提示
    setTimeout(() => {
        if (typeof Office === 'undefined' || !Office.context) {
            document.getElementById('load-fallback').style.display = 'block';
        }
    }, 5000);
</script>

4. 避免直接依赖DialogApi启动流程

不要把对话框作为加载项启动的唯一入口，让任务窗格本身具备基础的提示能力。即使对话框无法打开，用户也能在任务窗格中看到清晰的兼容性说明，而不是卡在加载状态。

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