使用Google Apps Script统计Gmail邮件总数时中途停止问题求助

核心原因 #

你的脚本只统计了前100条邮件线程的消息数——GmailApp.search()未指定maxResults参数时，默认仅返回前100条线程。假设这100条线程平均每条包含6-7条消息，总数刚好接近686，后续线程未被获取，导致统计停止。

另外还有两种潜在限制可能影响运行：

• 脚本运行时间限制：Google Apps Script单脚本最长运行时限为6分钟，若账户邮件量极大，一次性加载所有线程可能超时终止。
• Gmail服务配额：短时间内频繁调用getMessagesForThreads可能触发API配额限制，但你的情况更偏向分页未处理。

解决思路 #

1. 分页遍历所有线程：循环调用GmailApp.search，通过start和maxResults参数分批获取所有线程，直到没有更多线程返回。
2. 优化内存与日志：分批处理线程，避免一次性加载所有消息占用过多内存；加入日志方便调试进度。
3. 处理超时情况：若邮件量极大，可通过PropertiesService保存统计进度，分多次运行脚本完成统计。

修改后的脚本示例 #

function showEmailCount() {
  var myMe = Session.getActiveUser().getEmail();
  GmailApp.sendEmail(myMe, "邮件统计任务启动", "");

  var count = getEmailCount();
  GmailApp.sendEmail(myMe, "邮件统计完成", "你的邮箱共有 " + count + " 封邮件。");
}

function getEmailCount() {
  var totalCount = 0;
  const pageSize = 100; // 每次获取100条线程，可调整为最大500条
  let startIndex = 0;
  let threads;

  do {
    // 分页获取线程
    threads = GmailApp.search("in:anywhere", startIndex, pageSize);
    // 统计当前页所有线程的消息数
    const currentPageCounts = GmailApp.getMessagesForThreads(threads).map(msgs => msgs.length);
    // 累加到总数
    totalCount += currentPageCounts.reduce((sum, num) => sum + num, 0);
    // 更新下一页起始位置
    startIndex += pageSize;
    // 输出日志查看进度
    Logger.log("已处理线程数：%d，累计邮件数：%d", startIndex, totalCount);
  } while (threads.length === pageSize); // 返回线程数小于pageSize时，说明遍历完成

  return totalCount;
}

额外提示 #

• 查看运行日志：在Apps Script编辑器中点击「查看」→「日志」，可实时查看统计进度，确认是否遍历了所有线程。
• 配额检查：若脚本频繁失败，可通过「资源」→「云平台项目」查看Gmail API的配额使用情况，确认是否触发限制。
• 大邮件量处理：若账户邮件超过数万封，可将pageSize调至500（Gmail API单次搜索最大返回数），或拆分任务分多次运行。

内容的提问来源于stack exchange，提问作者J. Doe