Google Apps Script执行约5分钟超时 批量DocX转Google Docs问题咨询

问题根因 #

• Google Apps Script 单次运行最大时长限制为6分钟，2000个文件的转换、IO操作耗时必然超出限制，触发强制终止
• 现有代码存在逻辑错误：循环内连续两次调用files.next()，每轮循环会跳过1个文件，实际处理量仅为遍历到的文件数的一半

修复实现 #

1. 核心思路 #

通过PropertiesService存储已处理进度，搭配时间触发器实现自动分批续跑，每次处理到接近5分钟阈值时自动停止，触发下一次运行，直到所有文件处理完成。

2. 完整可用代码 #

// 配置参数
const SRC_FOLDER_ID = "XXXXXXX";
const DST_FOLDER_ID = SRC_FOLDER_ID;
// 单次处理最大时长，留1分钟余量避免超时，单位毫秒
const MAX_RUNTIME = 5 * 60 * 1000;
// 每次处理的文件数量上限，可根据实际转换速度调整
const BATCH_SIZE = 80;

// 初始化批量转换，第一次运行执行这个函数
function initBatchConvert() {
  // 清空之前的进度和触发器
  const scriptProps = PropertiesService.getScriptProperties();
  scriptProps.deleteAllProperties();
  deleteAllTriggers();
  // 启动第一次转换
  batchConvertDocxToDocs();
}

// 批量转换主逻辑
function batchConvertDocxToDocs() {
  const startTime = Date.now();
  const scriptProps = PropertiesService.getScriptProperties();
  // 读取已处理的文件ID集合
  const processedIds = new Set(JSON.parse(scriptProps.getProperty("processedIds") || "[]"));
  const files = DriveApp.getFolderById(SRC_FOLDER_ID).getFilesByType(MimeType.MICROSOFT_WORD);
  let processedCount = 0;

  while (files.hasNext() && processedCount < BATCH_SIZE && (Date.now() - startTime) < MAX_RUNTIME) {
    const file = files.next();
    const fileId = file.getId();
    // 跳过已处理的文件
    if (processedIds.has(fileId)) continue;

    try {
      // 转换为Google Docs
      const convertedFile = Drive.Files.copy(
        { parents: [{id: DST_FOLDER_ID}] },
        fileId,
        { convert: true }
      );
      // 可选：如果不需要后续编辑文档可以删除下面这行，减少耗时
      DocumentApp.openById(convertedFile.id);
      
      processedIds.add(fileId);
      processedCount++;
    } catch (e) {
      console.error(`处理文件${file.getName()}失败：${e.message}`);
      // 出错的文件也标记为已处理避免重复卡住，不需要可以删掉下面这行
      processedIds.add(fileId);
    }
  }

  // 保存进度
  scriptProps.setProperty("processedIds", JSON.stringify([...processedIds]));

  // 判断是否还有未处理的文件，有就创建下一次的触发器
  if (files.hasNext()) {
    // 1分钟后自动运行下一批，可调整间隔
    ScriptApp.newTrigger("batchConvertDocxToDocs")
      .timeBased()
      .after(1 * 60 * 1000)
      .create();
  } else {
    // 全部处理完成，清空进度和触发器
    scriptProps.deleteAllProperties();
    deleteAllTriggers();
    console.log("所有文件转换完成");
  }
}

// 清理所有关联触发器
function deleteAllTriggers() {
  const triggers = ScriptApp.getProjectTriggers();
  triggers.forEach(trigger => {
    if (trigger.getHandlerFunction() === "batchConvertDocxToDocs") {
      ScriptApp.deleteTrigger(trigger);
    }
  });
}

3. 前置配置 #

• 启用Drive高级服务：打开Apps Script编辑器，点击「服务」按钮（+号），找到「Drive API」，选择最新版本后点击添加
• 第一次运行时执行initBatchConvert函数，按提示完成授权即可，后续会自动续跑直到所有文件处理完成

额外优化建议 #

• 如果不需要对转换后的Google Docs做编辑操作，可以删除DocumentApp.openById(document.id)这行，能大幅提升处理速度
• 可根据实际转换耗时调整BATCH_SIZE参数，提升单次处理的文件数量，减少总运行批次

内容的提问来源于stack exchange，提问作者Web Conteúdo