Apps Script中.appendRow从数组追加时为何多出一行？

听起来你遇到的情况真的挺闹心的——明明日志显示sessionEmail已经正确捕获到了，但每次触发都会多出来一行空邮箱的记录。我来分享几个实战中常用的排查和解决思路：

1. 先排查「重复触发」的可能性 #

这是最常见的原因之一：

• 检查你是不是同时设置了两种触发方式？比如既加了表单提交的安装触发，又保留了onFormSubmit的简单触发，或者同时开了时间驱动触发和手动触发，导致函数被执行两次。
• 可以在函数开头加个日志，记录每次执行的时间和触发源：

  console.log(`函数执行时间：${new Date().toLocaleString()}，触发源：${ScriptApp.getTriggerSource()}`);
  

  运行后看日志，如果有两条时间接近的记录，那就是重复触发了。

2. 检查代码里的appendRow调用 #

仔细搜一下你的代码，是不是不小心调用了两次appendRow？比如：

• 主逻辑里调用了一次，某个分支（比如错误处理、条件判断里）又额外调用了一次；
• 或者在函数嵌套中，子函数也执行了追加操作。
  这种情况哪怕变量是对的，也会出现两行记录，其中一行可能因为上下文问题导致sessionEmail为空。

3. 注意Session.getActiveUser()的上下文限制 #

如果你的触发是时间驱动触发（比如定时执行），Session.getActiveUser().getEmail()会返回空值——因为这种触发是在服务器端无用户会话的环境下执行的！
如果同时存在「手动/表单触发（能拿到邮箱）」和「时间驱动触发（拿不到邮箱）」，就会出现一行有邮箱、一行空邮箱的情况。这时候要根据触发类型做判断：

var sessionEmail = "";
if (ScriptApp.getTriggerSource() === ScriptApp.TriggerSource.MANUAL || 
    ScriptApp.getTriggerSource() === ScriptApp.TriggerSource.FORM_SUBMIT) {
  sessionEmail = Session.getActiveUser().getEmail();
}
// 后续逻辑处理

4. 用执行锁防止并发重复执行 #

有时候网络延迟或者Google的触发机制偶发问题，会导致函数被重复调用。可以用LockService加个锁，确保同一时间只有一个实例在运行：

function yourTargetFunction() {
  // 获取脚本锁，等待10秒拿不到就退出
  var lock = LockService.getScriptLock();
  if (!lock.tryLock(10000)) {
    console.log("当前已有函数实例在运行，本次执行退出");
    return;
  }

  try {
    // 你的核心逻辑：获取sessionEmail、处理数据
    var sessionEmail = Session.getActiveUser().getEmail();
    console.log("捕获到的邮箱：", sessionEmail);
    // 追加行操作
    SpreadsheetApp.getActiveSpreadsheet().getSheetByName("你的表名").appendRow([sessionEmail, "其他字段值"]);
  } finally {
    // 无论成功失败都释放锁
    lock.releaseLock();
  }
}

5. 手动测试验证 #

先手动运行一次函数，看看是不是只追加一行。如果手动运行正常，那问题肯定出在触发配置上；如果手动运行也会出两行，那就是代码逻辑的问题，需要逐行排查分支条件和函数调用。

如果以上方法还没解决，你可以贴出核心代码片段，这样能更精准定位问题~

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