调用sync()后Excel Online加载项空白及Office.js初始化咨询

首先可以明确告诉你：完全可以重新初始化Office.js来解决这个闲置后上下文丢失的问题。在Excel Online环境中，加载项长时间闲置后，Office.js的运行时上下文确实可能会被静默回收，导致后续的sync()调用无响应，最终让加载项界面空白。下面是具体的解决方案和适配你代码的优化建议：

一、先判断Office.js上下文是否失效 #

在执行任何Excel操作前，先做一个轻量的有效性检测，避免直接执行核心逻辑导致失败：

this.isOfficeContextValid = function() {
  var deferred = $q.defer();
  Excel.run(function(ctx) {
    var workbook = ctx.workbook;
    workbook.load("name");
    return ctx.sync();
  }).then(function() {
    deferred.resolve(true);
  }).catch(function() {
    // 即使捕获到错误，也只返回无效状态，不抛出异常避免干扰
    deferred.resolve(false);
  });
  return deferred.promise;
};

二、实现Office.js的重新初始化 #

当检测到上下文失效时，重新触发Office的初始化流程。结合AngularJS的生命周期，确保初始化完成后再恢复业务操作：

this.reinitializeOffice = function() {
  var deferred = $q.defer();
  // 清理可能残留的未完成任务
  if (Office && Office.context) {
    // 可以取消当前挂起的Excel.Run操作（如果有）
    // 比如维护一个全局的任务队列，这里做清空处理
  }
  // 重新定义初始化逻辑
  Office.initialize = function(reason) {
    // 用$scope.$apply确保AngularJS感知到状态变化
    $scope.$apply(function() {
      deferred.resolve(reason);
    });
  };
  // 无需重新加载Office.js脚本，只需重新执行初始化逻辑即可
  return deferred.promise;
};

三、适配你的Heartbeat方法 #

修改你现有的heartbeat方法，先检测上下文有效性，失效则重新初始化后再执行原逻辑：

this.heartbeat = function (worksheetName, tableName) { 
    console.log('heartbeat'); 
    var deferred = $q.defer(); 

    // 先检查上下文是否有效
    this.isOfficeContextValid().then(function(isValid) {
      if (!isValid) {
        // 重新初始化Office.js
        return excelService.reinitializeOffice();
      }
      return Promise.resolve();
    }).then(function() {
      // 上下文正常或重新初始化完成，执行原Excel操作
      return Excel.run(function (ctx) { 
          var sheet = ctx.workbook.worksheets.getItem(worksheetName); 
          sheet.tables.load("name"); 
          var table = sheet.tables.getItem(tableName); 
          return ctx.sync() 
              .then(function () { 
                  table.rows.add();
                  return ctx.sync();
              })
              .then(function () { 
                  var lastRow = table.getRange().getLastRow(); 
                  lastRow.delete();
                  return ctx.sync();
              });
      });
    }).then(function () { 
      deferred.resolve(true); 
    }).catch(function (err) { 
        var error = excelService.convertError(err); 
        deferred.reject(error); 
    }); 
    return deferred.promise; 
};

四、额外优化建议 #

• 监听加载项可见性变化：使用Office.addin.onVisibilityModeChanged事件，当加载项从后台切换到前台时，主动检测并重新初始化上下文，避免用户操作时才触发问题：

  Office.addin.onVisibilityModeChanged(function(args) {
    if (args.visibilityMode === Office.VisibilityMode.Visible) {
      excelService.isOfficeContextValid().then(function(isValid) {
        if (!isValid) {
          excelService.reinitializeOffice();
        }
      });
    }
  });
  

• 简化sync()调用：你原来的代码里多次重复调用ctx.sync()，可以合并操作减少上下文交互次数，降低出错概率。

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