修复Google Sheets onEdit脚本报错：TypeError读取range属性未定义

报错原因分析 #

• TypeError: Cannot read properties of undefined (reading 'range') 核心原因是手动直接运行onEdit函数：onEdit是Google Sheets的简单触发器，仅当用户手动编辑表格时才会自动传入事件对象e，手动运行时e为undefined，因此无法读取e.range。
• 原代码还存在功能逻辑偏差：你需要监听C列（第3列）的编辑操作，但代码中错误判断为第2列（B列）；同时遍历查找ID的逻辑可优化效率。

修复后的完整代码 #

function onEdit(e) {
  // 拦截手动运行的情况，避免undefined报错
  if (!e) {
    throw new Error("请通过表格编辑触发此函数，不要手动运行！");
  }

  const activeSheet = e.source.getActiveSheet();
  // 校验当前工作表是否为「Studio」
  if (activeSheet.getName() !== "Studio") return;

  const editedRange = e.range;
  // 校验是否编辑的是C列（第3列）且值为"ready"
  if (editedRange.getColumn() !== 3 || editedRange.getValue() !== "ready") return;

  // 获取当前行B列的ID值
  const buybackId = activeSheet.getRange(editedRange.getRow(), 2).getValue();
  if (!buybackId) return; // ID为空时直接退出，避免无效查找

  // 打开目标表格Y
  const targetSS = SpreadsheetApp.openById('1bbNuH_GXbmNwMHk7Kjo0zAhD-QGwQqiva8_HJc3mgFY');
  const targetSheet = targetSS.getSheetByName("Status");
  if (!targetSheet) {
    throw new Error("未找到名为「Status」的工作表！");
  }

  // 遍历查找对应ID的行并更新状态
  const data = targetSheet.getDataRange().getValues();
  for (let i = 0; i < data.length; i++) {
    // 目标表格的ID存储在B列（数组索引为1）
    if (data[i][1] === buybackId) {
      // 将对应行的C列（第3列）设为"ready"
      targetSheet.getRange(i + 1, 3).setValue("ready");
      break; // 找到匹配项后退出循环，提升效率
    }
  }
}

关键修改点 #

• 新增if (!e)判断，手动运行时抛出明确提示，避免undefined报错。
• 将列判断从2.0改为3，匹配你需要监听的C列。
• 改用e.source.getActiveSheet()替代SpreadsheetApp.getActiveSpreadsheet()，更符合触发器的最佳实践。
• 添加ID空值检查，避免无效查找操作。
• 新增目标工作表存在性校验，提前拦截工作表名错误的情况。
• 找到匹配ID后添加break，减少不必要的循环遍历。

注意事项 #

• 不要手动运行onEdit函数，必须通过在「Studio」工作表的C列输入/选择"ready"来触发。
• 确保当前账号有权限访问目标表格Y（ID为1bbNuH_GXbmNwMHk7Kjo0zAhD-QGwQqiva8_HJc3mgFY）。

内容的提问来源于stack exchange，提问作者Michał Kostrzewa