每小时触发的Google Apps Script短时间运行3次的原因排查

一、先排查执行频次超标的触发源问题 #

先从触发器配置入手，定位1小时跑3次的根因：

• 检查重复/错配触发器
  打开脚本编辑器左侧时钟图标的「触发器」面板，列出所有绑定当前脚本的触发器：

  • 删除所有指向parseEmailByLabel的冗余触发器，仅保留1个时间驱动型触发器，确认时区配置和业务时区一致（比如国内业务选Asia/Shanghai），避免时区错配导致的补跑、重复调度
  • 检查是否存在非时间型触发器：比如误配置的Gmail新邮件到达触发器、Web App调用入口，这类触发源不会按小时规则执行，收到邮件/收到请求就会跑脚本，不需要的直接删除

  你提供的现有触发器配置参考：
  
  对应执行记录参考：
  

• 核对执行记录的触发来源
  打开「执行记录」面板，找到1小时内的3条执行记录，点进详情看「触发来源」字段：

  • 如果来源标注为「自动重试」，说明之前的脚本执行抛出了未捕获的异常，Apps Script 会自动重试失败任务，短时间内多次执行
  • 如果来源标注为「API/Web App调用」，说明有其他外部服务在主动调用你的脚本接口，需要排查对应调用方

• 注意时间触发器的固有调度特性
  Google 小时级时间触发器本身不保证准点执行，官方允许前后15分钟的调度偏移，不要卡整小时的时间点做业务判断。

二、修复代码逻辑缺陷，避免误告警和异常重试 #

你当前的代码存在4个致命问题，是导致异常重试、误发告警的核心原因：

1. 没有做标签存在性校验：如果ParseThis标签被误删，getUserLabelByName会返回null，后续调用null.getThreads()会直接抛异常，触发脚本自动重试
2. 判断逻辑完全失效：注意：getThreads()返回值是数组类型，你用数组和空字符串做==判断，会触发JS松散类型转换的坑，空数组[]和空字符串""比较时会被判定为相等，逻辑可靠性完全没有保障
3. 没有并发控制：如果脚本短时间内被多次触发（重试/多触发器），第一次执行把标签移除后，后续执行会直接判定为无待处理邮件，触发重复告警
4. 没有异常捕获：未处理的报错会触发平台自动重试机制，放大重复执行问题

修复后可直接用的代码 #

function parseEmailByLabel() {
  // 加执行锁，防止并发/重试导致重复执行
  const lock = LockService.getScriptLock();
  // 尝试拿锁，5秒拿不到直接退出，说明有其他执行在跑
  if (!lock.tryLock(5000)) return;

  try {
    const gmailLabelName = "ParseThis";
    const slackWebhook = "https://hooks.slack.com/workflows/T1234";
    const gmailLabelObject = GmailApp.getUserLabelByName(gmailLabelName);
    
    // 标签不存在直接记日志退出，不触发重试
    if (!gmailLabelObject) {
      Logger.log("指定标签不存在，请检查Gmail标签配置");
      return;
    }

    const threads = gmailLabelObject.getThreads();
    // 正确判断数组是否为空，用length属性判断，不要用字符串比较
    if (threads.length > 0) {
      // 有带标签的邮件，标记已读后移除标签
      threads.forEach(thread => {
        thread.getMessages().forEach(msg => msg.markRead());
        thread.removeLabel(gmailLabelObject);
      });
    } else {
      // 无待处理邮件，发Slack告警
      const params = { method: 'post' };
      const resp = UrlFetchApp.fetch(slackWebhook, params).getContentText();
      Logger.log("告警发送结果：" + resp);
    }
  } catch (e) {
    // 捕获所有异常，记日志后不触发平台自动重试
    Logger.log("脚本执行异常：" + e.message);
  } finally {
    // 执行完成释放锁
    lock.releaseLock();
  }
}

三、额外优化建议 #

• 如果要避免邮件延迟到达导致的误报，可以在判断无待处理邮件时加一层时间校验：比如检查距离上一次收到带标签邮件的时间，确认超过55分钟再发告警，给邮件投递留缓冲时间
• 可以在脚本属性里记录上次发告警的时间，设置50分钟的告警冷却期，即使脚本重复执行也不会在1小时内发多条重复告警

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