为何Google Apps Script的OnChange触发器会多次执行？

嘿，我懂你这闹心的情况——脚本本身功能正常，但OnChange触发器老是重复触发，导致邮件发好几遍，太烦人了！咱们一步步来排查解决：

可能导致重复触发的原因 #

• 你可能不小心创建了多个相同的OnChange触发器，每次表格更改都会触发所有实例
• OnChange的触发条件非常宽泛：单元格编辑、格式调整、插入/删除行列甚至列宽变化，都能触发它
• 脚本执行过程中如果有修改表格的操作（哪怕是无意的），可能会二次触发OnChange

具体解决方案 #

1. 先检查并清理重复触发器

先运行这段代码，查看项目里是否存在重复的OnChange触发器：

function listAllTriggers() {
  const triggers = ScriptApp.getProjectTriggers();
  triggers.forEach(t => {
    console.log(`触发器类型: ${t.getEventType()}, 绑定函数: ${t.getHandlerFunction()}`);
  });
}

如果输出里有多个绑定到emailPoaAsPDF的OnChange触发器，直接去脚本编辑器的「编辑」→「当前项目的触发器」页面删除多余的即可。

2. 给脚本加触发条件过滤+执行锁

修改你的主函数，让它只在特定场景下执行，同时加锁避免并发运行：

function emailPoaAsPDF(e) {
  // 只响应单元格编辑操作，过滤格式调整、行列更改等无关触发
  if (!e || e.changeType !== 'EDIT') return;

  // 加执行锁，防止同一时间多个脚本实例运行
  const lock = ScriptApp.newLock();
  if (!lock.tryLock(30000)) { // 最多等待30秒获取锁，超时则直接退出
    console.log('脚本正在执行中，本次触发已跳过');
    return;
  }

  try {
    var ss = SpreadsheetApp.openByUrl("https://docs.google.com/spreadsheets/d/1xEEEiLfil1qfetSwZRhr02Q9uoXvWtCxq22JywTu5mo/edit#gid=1872480652").getSheetByName("POA Temp");
    var email = ss.getRange("a37").getValue();
    var cc_email = "xxxxxx@gmail.com";
    var name = ss.getRange("a34").getValue();
    var sub = "xxxxxxxxxxxxxxxxxxxxxxxxxxxxx of "+ name;
    var body = "Hello "+ name + "," + "xxxxxxxxxxxxxxxxxxxx";
    
    var url='https://docs.google.com/spreadsheets/d/1xEEEiLfil1qfetSwZRhr02Q9uoXvWtCxq22JywTu5mo/export?';
    var exportOptions = 'exportFormat=pdf&format=pdf' + 
                        '&size=a4' + 
                        '&scale=2' + 
                        '&top_margin=1' + 
                        '&bottom_margin=1' + 
                        '&left_margin=1.25' + 
                        '&right_margin=1.25' + 
                        '&portrait=true' + 
                        '&fitw=false' + 
                        '&sheetnames=false&printtitle=false' + 
                        '&pagenumbers=false&gridlines=false' + 
                        '&fzr=false' + 
                        '&gid=1872480652';
    
    var params = {method:"GET",headers:{"authorization":"Bearer "+ ScriptApp.getOAuthToken()}};
    var response = UrlFetchApp.fetch(url+exportOptions, params).getBlob();
    
    GmailApp.sendEmail(email, sub, body, { 
      htmlBody: body, 
      cc: cc_email, 
      attachments: [{ 
        fileName: "xxx for " + ss.getRange("a34").getValue().toString() +".pdf", 
        content: response.getBytes(), 
        mimeType: "application/pdf" 
      }] 
    });
    
    // 原代码最后一行未完成，如有后续操作可在此补充
    // var nameFile = ss.getRange("e7").getValue().toString() + " for " + ss.getRange("a7").getValue().toString() +".pdf"
  } finally {
    lock.releaseLock(); // 无论执行成功或失败，都要释放锁
  }
}

• 新增e.changeType !== 'EDIT'判断，只响应单元格编辑触发
• 执行锁确保同一时间只有一个脚本实例运行，避免并发触发导致重复执行

3. 避免脚本内操作二次触发OnChange

如果你的脚本里有修改表格内容的操作，可以临时禁用触发器再执行，完成后恢复：

// 修改表格前禁用目标触发器
function disableTriggers() {
  const triggers = ScriptApp.getProjectTriggers();
  triggers.forEach(t => {
    if (t.getHandlerFunction() === 'emailPoaAsPDF') {
      ScriptApp.disableTrigger(t);
    }
  });
}

// 修改完成后恢复触发器
function enableTriggers() {
  const triggers = ScriptApp.getProjectTriggers();
  triggers.forEach(t => {
    if (t.getHandlerFunction() === 'emailPoaAsPDF') {
      ScriptApp.enableTrigger(t);
    }
  });
}

在需要修改表格的代码块前后调用这两个函数即可。

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