使用Google Apps Script实现Gmail附件批量下载到Google Drive的高效方法

免费版Google Apps Script单次执行时长上限为6分钟，超时核心原因是无效遍历、冗余操作过多，可通过以下方案优化：

1. 精准过滤目标邮件，砍掉无效遍历 #

不要拉取所有带指定标签的邮件再逐一判断是否星标、是否有附件，直接使用GmailApp.search()搭配Gmail搜索语法精准匹配符合条件的邮件，可大幅减少循环次数：

• 搜索语法：label:你的自定义标签名 -is:starred has:attachment
• 直接返回的结果就是带指定标签、未加星、有附件的邮件，不需要再额外判断isStarred()，也无需处理无附件邮件的逻辑，如果你需要留存无附件邮件的记录，可单独用label:你的自定义标签名 -is:starred has:noattachment搜索处理。

2. 移除冗余操作，降低单封邮件处理开销 #

• 删除冗余的copyBlob()调用：getAttachments()返回的附件对象本身可直接调用getAs()，无需额外复制blob，节省内存和处理时间
• 增加MIME类型判断：不要强制所有附件转image/jpeg，非图片附件转换会抛出异常中断执行，先判断附件类型再处理
• 替换文件名非法字符：邮件主题可能包含/\:*?"<>|等系统禁止的文件名字符，提前替换避免创建文件时报错
  优化后核心处理代码如下：

// 初始化进度存储、获取当前批次邮件
const props = PropertiesService.getUserProperties();
let startIndex = Number(props.getProperty('lastProcessedIndex') || 0);
const BATCH_SIZE = 15; // 单批次处理15个线程，可根据附件大小调整
const targetThreads = GmailApp.search('label:你的自定义标签名 -is:starred has:attachment', startIndex, BATCH_SIZE);
const targetFolder = DriveApp.getFolderById('你的目标Drive文件夹ID');

// 处理邮件
for (let i = 0; i < targetThreads.length; i++) {
  const messages = targetThreads[i].getMessages();
  for (let j = 0; j < messages.length; j++) {
    const currentMsg = messages[j];
    const msgSubject = currentMsg.getSubject().replace(/[\/\\:*?"<>|]/g, '_');
    const attachments = currentMsg.getAttachments();
    for (let k = 0; k < attachments.length; k++) {
      const att = attachments[k];
      // 仅处理图片附件，可根据需求修改过滤规则
      if (att.getContentType().startsWith('image/')) {
        const blob = att.getAs('image/jpeg').setName(`${msgSubject}_${k+1}_${att.getName()}`);
        targetFolder.createFile(blob);
      }
    }
    currentMsg.star(); // 标记已处理，避免重复执行时重复处理
  }
}

// 更新进度，设置下一次执行
if (targetThreads.length < BATCH_SIZE) {
  // 所有邮件处理完成，清除进度
  props.deleteProperty('lastProcessedIndex');
} else {
  // 存储当前处理位置，可搭配时间触发器每分钟执行一次脚本，自动处理下一批
  props.setProperty('lastProcessedIndex', String(startIndex + BATCH_SIZE));
}

3. 分批处理+进度持久化，突破单次执行时长限制 #

• 每次只处理固定数量的线程（单批次数量根据附件大小调整，大附件建议设为10以内，小附件可设为20）
• 用PropertiesService存储当前处理到的下标，处理完一批后更新进度
• 设置时间触发器，每隔1~2分钟自动触发脚本执行下一批，直到所有邮件处理完成，完全避免超时问题

4. 额外优化建议 #

• 不要对同一邮件的多个附件设置相同文件名，会导致重名覆盖，建议在文件名中增加附件序号、原始附件名避免覆盖
• 如果附件普遍较大，可以适当调小单批次处理的线程数量，避免单批次执行超时

内容的提问来源于stack exchange，提问作者Andy H.