Google Apps Script：文件转换超时、脚本中断且错误无法捕获

我之前也碰到过一模一样的问题！这种服务器错误确实特别头疼——它本质是Google Drive服务端的临时故障或资源限制，不属于常规JavaScript运行时错误，所以普通的try-catch根本抓不住。下面是我实测有效的几个解决方案：

1. 给转换操作加带延迟的重试机制 #

既然是服务器临时波动，重试几次大概率能成功。可以封装一个重试函数，每次失败后递增延迟时间再尝试，避免频繁请求触发更严格的限制：

function convertWithRetry(file, targetMimeType, maxRetries = 3) {
  let attempt = 0;
  while (attempt < maxRetries) {
    try {
      // 使用高级Drive API（需提前在脚本编辑器启用）执行转换，比DriveApp更稳定
      return Drive.Files.copy({
        title: file.getName().replace(/\.[^/.]+$/, ""),
        parents: file.getParents()
      }, file.getId(), {
        convert: true,
        mimeType: targetMimeType
      });
    } catch (e) {
      // 识别服务器错误并触发重试
      if (e.message.includes("server error") && attempt < maxRetries - 1) {
        attempt++;
        const delay = 2000 * attempt; // 每次重试延迟翻倍
        Utilities.sleep(delay);
        console.log(`转换失败，正在重试第${attempt}次...`);
      } else {
        throw e; // 非服务器错误或重试耗尽，抛出错误以便后续处理
      }
    }
  }
  throw new Error(`重试${maxRetries}次后仍无法转换文件: ${file.getName()}`);
}

注：高级Drive API需要在脚本编辑器中启用：点击「资源」>「高级Google服务」> 找到Drive API并开启

2. 拆分批量任务，避免一次性过载 #

如果是批量转换大量文件，一次性处理太多会触发Google的服务器资源阈值，直接导致超时崩溃。可以把文件分成小批量，用时间驱动触发器分批处理：

function processFileBatch(fileIds) {
  const batchSize = 10; // 每批处理10个文件，可根据情况调整
  for (let i = 0; i < fileIds.length; i += batchSize) {
    const currentBatch = fileIds.slice(i, i + batchSize);
    currentBatch.forEach(fileId => {
      const file = DriveApp.getFileById(fileId);
      try {
        // 根据原文件类型指定目标Google文件类型
        const targetMimeType = file.getMimeType() === "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet" 
          ? "application/vnd.google-apps.spreadsheet" 
          : "application/vnd.google-apps.document";
        convertWithRetry(file, targetMimeType);
      } catch (e) {
        console.log(`文件转换失败: ${file.getName()}，错误信息: ${e.message}`);
        // 可选：把失败文件记录到Google Sheet，方便后续手动处理
        logFailedFile(file.getName(), e.message);
      }
    });
    Utilities.sleep(5000); // 每批处理完暂停5秒，降低服务器压力
  }
}

// 错误日志记录函数
function logFailedFile(fileName, errorMsg) {
  const logSheet = SpreadsheetApp.openById("你的日志Sheet ID").getActiveSheet();
  logSheet.appendRow([new Date(), fileName, errorMsg]);
}

3. 提前过滤无法转换的文件 #

有些Office文件Google本身就不支持转换，提前筛选能避免不必要的错误：

• 带VBA宏的文件（如.xlsm、.docm）：Google无法直接转换，需手动处理
• 加密文件：无法读取内容，直接跳过
• 超大文件：比如超过50MB的Excel，转换成功率极低，可提前标记
• 损坏文件：可以通过尝试读取文件元数据或捕获特定错误（如"File is corrupted"）来识别

4. 启用脚本的错误报告 #

在脚本编辑器中开启「错误报告」：点击「编辑」>「当前项目的触发器」> 右上角「更多」>「项目设置」> 勾选「启用错误报告」。这样即使脚本崩溃，你也能收到邮件通知，了解错误的详细触发场景。

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