Google Sheets触发器无法传递参数问题求助

问题原因 #

• 直接在脚本编辑器手动运行onEdit函数：此时Google Apps Script不会自动传递事件对象e，必然触发Cannot read properties of undefined错误。
• 自定义触发器配置错误：如果手动创建了触发器，但事件源/类型选错（比如选了时间驱动而非编辑触发）、函数名不匹配，也会导致e未定义。
• 权限限制：e.user.getEmail()需要额外授权，若未完成授权流程，会引发执行失败。

解决方案 #

1. 正确触发函数 #

绝对不要手动运行onEdit函数，直接在你的Google Sheets表格中编辑任意单元格，系统会自动传递事件对象e，函数才能正常执行。

2. 检查自定义触发器配置（若使用） #

如果你手动创建了触发器（而非依赖默认的简单触发器），按以下步骤核对：

• 打开脚本编辑器，点击左侧「触发器」图标（闹钟样式）。
• 确认触发器的「事件源」为「电子表格」，「事件类型」为「编辑时」。
• 确认触发器关联的函数名是onEdit（大小写完全一致）。

3. 优化代码，增加安全判断 #

针对e可能未定义、用户邮箱为空、Audit表不存在的情况，给代码增加容错逻辑：

function onEdit(e) {
  // 阻止手动运行导致的报错
  if (!e) {
    throw new Error("请通过编辑表格触发该函数，不要手动运行");
  }
  
  var sheet = e.source.getActiveSheet();
  // 处理用户邮箱无法获取的情况
  var name = e.user ? e.user.getEmail() : "未知用户";
  var date = new Date();
  var row = e.range.getRow();
  var col = e.range.getColumn();
  var value = e.value;
  
  // 检查Audit工作表是否存在
  var auditSheet = e.source.getSheetByName("Audit");
  if (!auditSheet) {
    throw new Error("未找到名为'Audit'的工作表，请先创建该表");
  }
  
  auditSheet.appendRow([sheet.getName(), row, col, value, name, date, "onEdit"]);
}

4. 重新完成授权流程 #

如果执行日志显示权限相关错误，重新触发授权：

• 在脚本编辑器中点击「运行」按钮，按提示完成授权步骤，确保授予脚本访问用户邮箱和编辑表格的权限。

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