React开发的Excel JS插件跨文件写入触发RichApi.Error求助

核心问题原因 #

1. 异步并行执行冲突：你用forEach遍历公司列表时，每个回调都是async函数，这会导致多个Excel.run操作同时并行执行。切换Excel文件后，未完成的Excel.run仍绑定旧工作簿上下文，新操作尝试绑定新工作簿上下文，两者冲突触发内部错误。
2. 错误捕获失效：外层try/catch无法捕获forEach内部异步函数的错误——forEach不会等待异步回调完成，错误会被静默抛出，最终触发Excel API的内部异常。
3. 上下文管理混乱：切换工作簿后，Excel的上下文对象会更新，但并行的Excel.run可能还在使用旧的上下文引用，导致操作指向已失效的工作簿。

具体修复方案 #

1. 替换forEach为顺序异步循环 #

用for...of替代forEach，确保每个公司的数据请求和Excel写入操作顺序执行，避免并行上下文冲突：

try {
  var allCompanies = [12, 32, 33, 43, 45, 66, 12, 32, 10, 12, 21, 90];
  // 用for...of顺序处理每个公司
  for (const _company of allCompanies) {
    try {
      const responseRows = await fetchData(_company);
      await Excel.run(async (context) => {
        let sheet = context.workbook.worksheets.getActiveWorksheet();
        sheet.load(["name"]);
        await context.sync();
        
        // 保留你的数据操作逻辑：创建表格、写入单元格等
        for (let i = 0; i < responseRows.length; i++) {
          // data operations into Excel sheet
          // creating table, table header, applying Css
          // writing value to each cells
        }
        
        sheet.getUsedRange().format.autofitColumns();
        sheet.getUsedRange().format.autofitRows();
        await context.sync();
      });
    } catch (fetchOrExcelError) {
      console.error(`处理公司${_company}时出错:`, fetchOrExcelError);
      // 可选：继续处理下一个公司，或终止流程
      // throw fetchOrExcelError;
    }
  }
} catch (error) {
  console.error("整体流程出错:", error);
}

2. 强化错误边界处理 #

• 给每个fetchData和Excel.run单独添加try/catch，避免单个公司的错误导致整个流程中断。
• 捕获Excel.run内部的RichApi错误时，打印当前活动工作表名称、公司ID等上下文信息，方便定位问题。

3. 验证工作簿上下文有效性 #

在Excel.run内部，可先验证当前工作簿是否为预期的活动工作簿，避免操作到错误文件：

await Excel.run(async (context) => {
  const workbook = context.workbook;
  workbook.load("name");
  await context.sync();
  console.log("当前操作的工作簿:", workbook.name);
  
  let sheet = workbook.worksheets.getActiveWorksheet();
  sheet.load(["name"]);
  await context.sync();
  
  // 后续操作...
});

4. 优化Excel操作性能 #

• 尽量减少context.sync()的调用次数，批量执行单元格写入和格式设置，避免频繁与Excel内核通信。
• 创建表格时，建议一次性传入所有数据行，而非逐行写入，减少API调用次数。

额外排查点 #

• 检查fetchData函数是否存在跨域或缓存问题，切换工作簿后API返回的数据是否异常。
• 测试单个工作簿中多次操作是否正常，排除切换工作簿导致的上下文失效问题。
• 查看Excel插件的权限设置，确保插件有权限访问多个打开的工作簿。

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