Apps Script的onChange/onEdit函数单次操作重复执行4次问题

AI 小北

2026-8-30

问题产生原因

这个问题和POST请求是否分批写入、选择onChange还是onEdit作为触发事件没有关系，核心原因是当前绑定的脚本项目下累计了4个指向同一目标函数的重复可安装触发器：

你在调试、部署脚本的过程中，很可能反复执行过触发器创建操作：要么是在触发器管理面板多次新建同类型触发规则没删旧的，要么是代码里写了动态创建触发器的逻辑、但没有做去重判断，每次运行代码就会新增一个触发器，失效的旧触发器不会被系统自动清理，累计到4个之后，每次触发事件到来，4个触发器会各自独立调用一次目标函数，就会出现固定重复执行4次的现象。
如果你同时混用了Google Apps Script内置的简单触发器（直接命名为onEdit/onChange、不需要手动在面板创建的函数）和同事件的可安装触发器，也会额外增加触发次数，但你遇到的固定4次重复的表现，完全符合重复触发器累计的特征。

修复方案

按照以下步骤操作即可解决：

第一步：清理所有重复的无效触发器
打开表格绑定的脚本编辑器，点击左侧栏的时钟样式「触发器」按钮，在弹出的触发器列表里，找到所有绑定到当前表格、触发条件为「编辑时」「变更时」的条目，只保留1个你实际需要的触发器，其余全部点击右侧菜单的删除选项移除。
如果你是通过代码动态创建触发器，必须在创建逻辑前增加去重判断，避免每次运行代码都新增重复触发器，参考代码如下：
```
function createSingleTrigger() {
  // 先清理所有指向目标函数的旧触发器
  const existingTriggers = ScriptApp.getProjectTriggers();
  existingTriggers.forEach(trigger => {
    if (trigger.getHandlerFunction() === 'createAndSendDocument') {
      ScriptApp.deleteTrigger(trigger);
    }
  });
  // 清理完成后再创建新触发器
  ScriptApp.newTrigger('createAndSendDocument')
    .forSpreadsheet(SpreadsheetApp.getActiveSpreadsheet())
    .onChange()
    .create();
}
```

第二步：增加执行防抖（可选，适配外部API写入场景）
如果后续需要对接POST批量写入的场景，避免单次写入多单元格/多行导致的重复触发，可以在业务函数开头加锁+执行间隔判断，拦截短时间内的重复调用，参考代码如下：

const scriptLock = LockService.getScriptLock();
const scriptProps = PropertiesService.getScriptProperties();

function createAndSendDocument() {
  // 5秒内拿不到执行锁，说明已有运行中的实例，直接退出
  if (!scriptLock.tryLock(5000)) return;
  try {
    // 距离上次执行不足10秒，判定为重复触发，直接退出
    const lastRunTime = Number(scriptProps.getProperty('last_run') || 0);
    const currentTime = Date.now();
    if (currentTime - lastRunTime < 10000) return;

    // 此处放你原本的业务逻辑
    // ......

    // 业务逻辑执行完成后更新最后执行时间
    scriptProps.setProperty('last_run', currentTime.toString());
  } finally {
    // 无论执行成功失败都释放锁
    scriptLock.releaseLock();
  }
}

第三步：验证修复效果
清理完成后手动修改单个单元格，到脚本编辑器左侧的「执行记录」面板查看，确认每次编辑操作只生成1条函数执行记录，再恢复POST请求写入流程测试即可。

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