如何修复Google脚本邮件处理中间歇性的‘Exceeded maximum execution time’错误

问题背景 #

我是Google脚本新手，编写的脚本用于将发货通知邮件转成短信通知，设置为每分钟触发。每周会多次出现Exceeded maximum execution time错误：脚本正常执行仅需约1秒，但偶尔会超出6分钟时限。添加console.log后仅能看到超时提示，无法定位具体卡顿代码段。

原代码如下：

function myFunction() {

  //setup text number for sending notification
  var textnum = "**********@vtext.com"
  console.log("Script Started")

  //send search criteria for processing emails
  var threads = GmailApp.search("is:unread");
  Utilities.sleep(250) //pause to allow all searched info to come back
  console.log("Gmail searched")

  //forward any new emails
  if (threads.length > 0) {
    console.log("Search threads > 0")
          
    //process all emails that meet search criteria
    for (var i = 0; i < threads.length; i++) {
      console.log("Email " + i + " getting checked")
      //find the body of the email
      var message = threads[i].getMessages();
      var body = message[0].getPlainBody();
      console.log("Email " + i + " checked")

      //forward email and mark as read
      GmailApp.sendEmail(textnum , "", body);
      console.log("Email sent")
      threads[i].markRead();
      console.log("Email marked as read")

      //data log
      console.log (body);
    }
  }
 console.log("Script end")
}

问题分析 #

间歇性超时的核心是Gmail服务的API调用延迟波动，再加上脚本本身的几个风险点放大了问题：

• 无限制的is:unread搜索可能某次返回大量未读线程，循环内逐个调用API会累积耗时
• 循环内重复调用getMessages()、sendEmail()、markRead()等高延迟服务方法，单次调用的波动会被放大
• 不必要的Utilities.sleep(250)纯属多余，GmailApp.search是同步方法，返回时已获取完整结果

修复方案 #

1. 缩小搜索范围，避免批量处理 #

给搜索语句添加时间限制，仅处理最近10分钟的未读邮件（匹配每分钟触发的频率）：

var threads = GmailApp.search("is:unread newer_than:10m");

2. 批量处理API调用，减少服务交互 #

GmailApp支持批量操作，将循环内的单个调用改为批量执行，大幅降低延迟：

• 批量收集邮件内容
• 合并内容发送单条短信（减少sendEmail调用次数）
• 批量标记线程为已读

3. 移除不必要的延迟 #

直接删除Utilities.sleep(250)，同步方法无需额外等待

4. 添加超时保护 #

在循环中加入执行时间检查，避免单次执行接近6分钟时限：

var startTime = new Date().getTime();
for (var i = 0; i < threads.length; i++) {
  // 留1分钟缓冲，接近超时则停止处理
  if (new Date().getTime() - startTime > 5 * 60 * 1000) {
    console.log("接近超时，停止处理剩余邮件");
    break;
  }
  // 后续处理逻辑
}

修改后的完整代码 #

function myFunction() {
  // 短信接收地址
  var textnum = "**********@vtext.com";
  console.log("脚本启动");

  // 仅搜索最近10分钟的未读邮件，避免批量处理
  var threads = GmailApp.search("is:unread newer_than:10m");
  console.log("Gmail搜索完成，找到" + threads.length + "条未读线程");

  if (threads.length > 0) {
    console.log("开始处理邮件");
    var startTime = new Date().getTime();
    var emailBodies = [];

    // 批量收集邮件内容
    for (var i = 0; i < threads.length; i++) {
      // 超时保护：剩余1分钟时停止
      if (new Date().getTime() - startTime > 5 * 60 * 1000) {
        console.log("接近超时，停止处理剩余邮件");
        break;
      }
      console.log("处理第" + i + "封邮件");
      var message = threads[i].getMessages()[0];
      emailBodies.push(message.getPlainBody());
      console.log("第" + i + "封邮件内容已收集");
    }

    // 合并内容发送单条短信（如需分开发送可保留循环内sendEmail，但建议合并）
    if (emailBodies.length > 0) {
      var combinedBody = emailBodies.join("\n\n---\n\n");
      GmailApp.sendEmail(textnum, "", combinedBody);
      console.log("短信发送完成");
      // 批量标记已读
      GmailApp.markThreadsRead(threads.slice(0, emailBodies.length));
      console.log("已处理邮件标记为已读");
    }
  }
  console.log("脚本结束");
}

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