如何用try/catch处理Google Sheets onEdit(e)超时错误并实现重试

为什么当前递归重试无效 #

Maximum execution time exceeded是Google Apps Script的全局超时限制（当前为6分钟），触发后整个脚本会直接终止，catch块根本不会执行，所以递归调用guardarMarca完全起不到重试作用。而且你的代码本身存在大量低效操作，这才是批量编辑时超时的核心原因。

第一步：优化代码性能（从根源减少超时概率） #

你的代码在循环中反复调用getRange和setValue，这些都是耗时的IO操作，必须先做批量读写优化：

var activeSheet;
var relacionamentoSheet;
var marcasData; // 缓存marcas表数据，避免重复读取

// 初始化全局资源，只执行一次
function init() {
  const ss = SpreadsheetApp.getActive();
  activeSheet = ss.getSheetByName('main');
  relacionamentoSheet = ss.getSheetByName('relacionamento');
  
  // 一次性读取marcas表的有效数据，不用固定范围
  const marcasSheet = ss.getSheetByName('marcas');
  marcasData = marcasSheet.getDataRange().getValues();
}

function onEdit(e) {
  init();
  
  const range = e.range;
  const rowStart = range.rowStart;
  const rowEnd = range.rowEnd;
  const colStart = range.columnStart;
  const colEnd = range.columnEnd;
  
  // 只处理main表的编辑
  if (range.getSheet().getName() !== activeSheet.getName()) return;
  // 只处理第3列的编辑
  if (colStart > 3 || colEnd < 3) return;
  
  // 批量读取编辑区域的值
  const editValues = range.getValues();
  // 批量读取relacionamento表对应行的数据
  const relacionamentoValues = relacionamentoSheet.getRange(rowStart, 1, rowEnd - rowStart + 1, 1).getValues();
  
  // 循环处理每个单元格（内存中操作，无IO）
  for (let rowIdx = 0; rowIdx < editValues.length; rowIdx++) {
    const value = editValues[rowIdx][colStart - 3] || ""; // 仅处理第3列，列偏移为0
    
    if (value === "") {
      relacionamentoValues[rowIdx][0] = "";
    } else {
      // 从缓存数据中快速匹配
      const match = marcasData.find(item => item[1] === value);
      relacionamentoValues[rowIdx][0] = match ? match[0] : relacionamentoValues[rowIdx][0];
    }
  }
  
  // 批量写入处理结果
  relacionamentoSheet.getRange(rowStart, 1, relacionamentoValues.length, 1).setValues(relacionamentoValues);
}

额外性能优化点 #

• 避免在循环中重复调用getActive()、getSheetByName()，提前初始化缓存
• 用getDataRange()替代固定范围（如A1:B100），只读取实际有数据的区域
• 用数组find()方法替代手动循环遍历，效率更高且代码更简洁

第二步：实现超时重试机制 #

如果优化后仍偶尔超时，需要用可安装触发器实现重试——简单触发onEdit无法在超时后重启，可安装触发器能脱离原执行上下文重新运行：

1. 编写重试核心逻辑 #

function retryOnEdit(editEvent) {
  try {
    processEdit(editEvent);
  } catch (err) {
    if (err.message.includes('Maximum execution time exceeded')) {
      // 记录重试日志
      Logger.log(`超时，准备重试编辑事件: ${JSON.stringify(editEvent)}`);
      
      // 记录重试次数，避免无限循环
      let retryCount = Number(ScriptProperties.getProperty('retryCount')) || 0;
      if (retryCount >= 3) {
        Logger.log("重试次数达上限，终止重试");
        ScriptProperties.deleteProperty('retryCount');
        ScriptProperties.deleteProperty('pendingEditEvent');
        return;
      }
      
      // 设置1分钟后重试
      ScriptApp.newTrigger('retryOnEdit')
        .timeBased()
        .after(60000)
        .create();
      
      // 保存待处理的编辑事件和重试次数
      ScriptProperties.setProperty('pendingEditEvent', JSON.stringify(editEvent));
      ScriptProperties.setProperty('retryCount', String(retryCount + 1));
    } else {
      Logger.log(`编辑处理失败: ${err.message}`);
    }
  }
}

// 抽离核心处理逻辑，供onEdit和重试函数复用
function processEdit(e) {
  init();
  
  const range = e.range;
  const rowStart = range.rowStart;
  const rowEnd = range.rowEnd;
  const colStart = range.columnStart;
  const colEnd = range.columnEnd;
  
  if (range.getSheet().getName() !== activeSheet.getName()) return;
  if (colStart > 3 || colEnd < 3) return;
  
  const editValues = range.getValues();
  const relacionamentoValues = relacionamentoSheet.getRange(rowStart, 1, rowEnd - rowStart + 1, 1).getValues();
  
  for (let rowIdx = 0; rowIdx < editValues.length; rowIdx++) {
    const value = editValues[rowIdx][colStart - 3] || "";
    
    if (value === "") {
      relacionamentoValues[rowIdx][0] = "";
    } else {
      const match = marcasData.find(item => item[1] === value);
      relacionamentoValues[rowIdx][0] = match ? match[0] : relacionamentoValues[rowIdx][0];
    }
  }
  
  relacionamentoSheet.getRange(rowStart, 1, relacionamentoValues.length, 1).setValues(relacionamentoValues);
  
  // 处理完成后清除缓存的待处理事件和重试次数
  ScriptProperties.deleteProperty('pendingEditEvent');
  ScriptProperties.deleteProperty('retryCount');
}

2. 修改onEdit触发重试流程 #

function onEdit(e) {
  retryOnEdit(e);
}

3. 配置可安装触发器 #

• 打开脚本编辑器，点击左侧「触发器」图标
• 点击「添加触发器」，配置如下：
  • 选择函数：retryOnEdit
  • 事件源：「时间驱动」
  • 事件类型：「分钟计时器」（按需设置，代码中已通过after()创建一次性触发器）
  • 保存并授权脚本权限

内容的提问来源于stack exchange，提问作者Guilherme Sousa Ribeiro