Excel Online JavaScript Add-in会话超时问题解决方案咨询

我之前开发Excel Online插件时也踩过会话超时的坑，结合微软官方给出的核心逻辑和实际落地的可行方案，给你整理几个能解决问题的思路：

一、模拟无感知交互续命（最贴合官方建议的方案） #

根据官方文档提到的：

要防止会话超时，您必须与工作簿进行交互，这可能包括在工作簿中导航……

我们可以定时执行一个无侵入的微小工作簿操作，来重置会话超时计时器。比如每隔12分钟（比15-20分钟的超时窗口提前）执行一次轻量的Excel.run()操作，完全不会干扰用户：

// 定时续命函数
function keepSessionAlive() {
  Excel.run(async (context) => {
    // 读取任意单元格的基础属性（无感知操作，不会修改内容）
    const cell = context.workbook.getActiveCell();
    cell.load("address");
    await context.sync();
    console.log("会话续命成功");
  }).catch((error) => {
    // 处理异常，比如用户已关闭工作簿
    console.error("续命失败:", error);
    // 停止定时任务
    clearInterval(sessionInterval);
  });
}

// 启动定时任务，每12分钟执行一次（720000毫秒）
const sessionInterval = setInterval(keepSessionAlive, 720000);

注意：不要把间隔设得太短（比如小于5分钟），避免给服务器造成不必要的压力；如果插件处于后台标签页，浏览器可能会限制定时器，这时候可以结合visibilitychange事件，仅在标签页可见时执行续命操作。

二、替换会话变量为持久化存储 #

如果业务场景允许，尽量避免依赖会话变量，改用持久化存储方案：

• 使用Office.context.document.settings：这是Office官方提供的与当前工作簿绑定的存储，数据会随工作簿保存，不会因为会话超时丢失，适合存储和工作簿关联的配置或状态。
• 使用浏览器localStorage：如果数据不需要和工作簿绑定，可以存在浏览器本地，但要注意跨域限制和用户清理缓存的情况。

示例代码（用Office Settings存储）：

// 存储数据
Office.context.document.settings.set("pluginState", JSON.stringify({ key: "value" }));
Office.context.document.settings.saveAsync((result) => {
  if (result.status === Office.AsyncResultStatus.Succeeded) {
    console.log("数据保存成功");
  }
});

// 读取数据
const savedState = Office.context.document.settings.get("pluginState");
if (savedState) {
  const state = JSON.parse(savedState);
  console.log("读取到的状态:", state);
}

三、优化会话变量的使用逻辑 #

如果必须使用会话变量，尽量缩小其使用范围：

• 只在短期需要的场景下使用会话变量，用完后立即调用Office.context.document.removeItem()清理。
• 将大的状态拆分为多个小项，避免一次性存储过多数据导致会话内存占用过高。

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