Google Sheets脚本报错TypeError: Cannot read property 'range' of undefined求助

错误原因 #

报错核心是**event参数为undefined**：

• 你的代码依赖event.range获取表单提交的行信息，但这个event对象只有在通过表单提交触发器或工作表编辑触发器触发函数时，才会由Google自动传入。
• 如果手动运行AddNewMembers或CheckHandleSteamIDNotation，event会是空值，自然无法读取range属性，直接抛出报错。

同时代码还有两个潜在问题：

1. 硬编码固定单元格（R3、J3、I100），逻辑无法适配新的表单提交行
2. CheckHandleSteamIDNotation中用getLastRow()获取目标行，在多用户提交场景下可能取到错误行

修复方案 #

1. 绑定正确的触发器（必做） #

给AddNewMembers绑定表单提交触发器，确保函数触发时能拿到合法的event对象：

• 打开脚本编辑器，点击左侧「触发器」图标
• 添加触发器：选择AddNewMembers函数，事件源选「电子表格」，事件类型选「表单提交」

2. 优化代码逻辑 #

修改CheckHandleSteamIDNotation函数，兼容手动测试并修复行获取逻辑：

function CheckHandleSteamIDNotation(event) {
  // 自动触发时用event的工作表，手动测试时指定表单响应表名
  let formSheet = event ? event.range.getSheet() : SpreadsheetApp.getActiveSpreadsheet().getSheetByName('Recruitment Log');
  // 自动触发时用event的行，手动测试时取最后一行
  let targetRow = event ? event.range.getRow() : formSheet.getLastRow();

  let header = formSheet.getRange(1, 1, 1, formSheet.getMaxColumns()).getValues();
  let formRange = formSheet.getRange(targetRow, 1, 1, formSheet.getMaxColumns());
  let formValues = formRange.getValues();

  for (let i = 0; i < header[0].length; i++) {
    if (header[0][i].includes("SteamID")) {
      // 避免重复添加单引号
      if (!formValues[0][i]?.startsWith("'")) {
        formValues[0][i] = "'" + formValues[0][i];
      }
    }
  }
  formRange.setValues(formValues);
}

修改AddNewMembers函数，基于提交行动态获取数据，不再依赖固定单元格：

function AddNewMembers(event){
  CheckHandleSteamIDNotation(event);
  SpreadsheetApp.flush();

  var ss = SpreadsheetApp.getActiveSpreadsheet();
  var recruitment_log = ss.getSheetByName('Recruitment Log');
  var main_roster = ss.getSheetByName('Main Roster');

  // 从提交行获取数据（第18列是R列，第10列是J列）
  let submittedRow = event.range.getRow();
  var isAdded = recruitment_log.getRange(submittedRow, 18).getValue();
  var recruit_id = "'" + recruitment_log.getRange(submittedRow, 10).getValue();

  if(isAdded == "No") {
    // 找到Main Roster的下一个空行（代替固定I100）
    var nextEmptyRow = main_roster.getLastRow() + 1;
    main_roster.getRange(nextEmptyRow, 9).setValue(recruit_id);
  }
}

3. 手动测试注意事项 #

如果要手动运行测试，需要在CheckHandleSteamIDNotation中把表单响应表名替换成你实际的工作表名称，同时确保测试行的SteamID列没有重复单引号。

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