带WebView2组件的Outlook加载项卸载时机及强制卸载方法咨询

WebView2卸载时机说明 #

Office（包括Outlook）加载项中的WebView2实例并非在面板关闭后立即销毁，而是会进入宿主的缓存池复用，以此提升后续加载项的启动速度。官方并未公开精确的销毁时机，因为这由Office的动态资源管理策略决定——只有当系统资源紧张、或加载项长时间未被访问时，宿主才会回收这些缓存的WebView2实例。

解决会话冲突的可行方案 #

1. 利用加载项关闭事件主动清理会话

在加载项中监听AddinClosed事件，触发时主动向后端发送会话终止请求，直接切断旧连接：

Office.onReady(() => {
  // 注册加载项关闭事件处理器
  Office.context.addin.onClose.addHandlerAsync(async () => {
    // 调用后端接口终止当前会话
    await fetch('/api/end-user-session', {
      method: 'POST',
      credentials: 'include'
    });
  });
});

这个方法能在面板关闭的第一时间清理后端会话，从根源避免残留连接导致的冲突。

2. 配置禁用WebView2复用

在加载项的manifest.xml中添加disableWebViewReuse配置，强制关闭面板后销毁WebView2实例（需Office 365最新版本支持）：

<Runtime>
  <WebViewRuntime disableWebViewReuse="true" />
</Runtime>

注意：该配置会降低加载项的启动速度（每次打开都需新建WebView2实例），需在启动速度和会话稳定性之间做权衡。

3. 后端优化会话校验逻辑

针对后端“单浏览器实例会话”的限制，增加心跳校验机制：

• 前端每隔30秒向后端发送一次心跳请求，后端记录每个会话的最后活跃时间；
• 当新的加载项连接请求到来时，后端检查旧会话的最后活跃时间，若超过5分钟无心跳，自动终止旧会话并允许新会话建立。

这种方式能兼容WebView2的缓存机制，即使WebView2未立即销毁，后端也能主动清理失效会话。

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