Google Apps Script生成PDF时保存关闭超时问题求助（已加重试）

我用Google Apps Script关联Google Docs生成PDF报告，同时对接OpenAI生成内容。因为整个流程耗时较长，运行代码时频繁出现文档保存关闭时间不足的报错。虽然已经给代码加了重试机制和休眠逻辑，但问题依然存在。

以下是我目前使用的重试相关代码：

function safeSaveAndClose(doc, retries = 5, backoffMs = 5000) {
  for (let i = 1; i <= retries; i++) {
    try {
      doc.saveAndClose();
      console.log(`✅ doc saved on try #${i}`);
      return;
    } catch (e) {
      console.warn(`⚠️ saveAndClose() failed on try #${i}: ${e}`);
      if (i < retries) Utilities.sleep(backoffMs * i);
    }
  }
  throw new Error(`Couldn’t save document after ${retries} attempts.`);
}

/**
 * Try to open a Doc up to `retries` times, with exponential backoff.
 */
function openDocWithRetry(id, retries = 8, backoffMs = 10000) {
  for (let i = 1; i <= retries; i++) {
    try {
      return DocumentApp.openById(id);
    } catch (e) {
      console.warn(`⚠️ openById failed on try #${i}: ${e}`);
      Utilities.sleep(backoffMs * i);
    }
  }
  throw new Error(`Couldn’t open document ${id} after ${retries} attempts.`);
}

function exportPdfWithRetry(docId, retries = 5, backoffMs = 8000) {
  for (let i = 1; i <= retries; i++) {
    try {
      return exportDocAsPDF(docId);
    } catch (e) {
      console.warn(`⚠️ exportDocAsPDF failed on try #${i}: ${e}`);
      if (i < retries) Utilities.sleep(backoffMs * i);
    }
  }
  throw new Error(`Couldn’t export PDF after ${retries} attempts.`);
}

const reportFile = DriveApp
  .getFilesByName('Inner Peace Report Template')
  .next()
  .makeCopy(`Inner Peace Report – ${userName}`);

// give Drive extra time...
Utilities.sleep(15000);
const doc = openDocWithRetry(reportFile.getId());
const body = doc.getBody();

// ... rest of your build logic, ending with:
safeSaveAndClose(doc);
const pdfBlob = exportPdfWithRetry(reportFile.getId())
                   .setName(`Your Inner Peace Report – ${userName}.pdf`);

优化方案 #

1. 强制同步文档更改再保存 #

在调用saveAndClose前，先调用doc.flush()强制同步所有未提交的编辑操作，避免异步更改未完成就触发保存：

// 在执行safeSaveAndClose前添加这行
doc.flush();
safeSaveAndClose(doc);

同时可以修改safeSaveAndClose函数，把flush整合进去：

function safeSaveAndClose(doc, retries = 7, backoffMs = 8000) {
  for (let i = 1; i <= retries; i++) {
    try {
      doc.flush(); // 先同步所有更改
      doc.saveAndClose();
      console.log(`✅ 第${i}次尝试保存文档成功`);
      return;
    } catch (e) {
      console.warn(`⚠️ 第${i}次尝试保存失败：${e}`);
      if (i < retries) {
        // 用1.5倍指数退避，避免等待时间过长
        Utilities.sleep(backoffMs * Math.pow(1.5, i-1));
      }
    }
  }
  throw new Error(`经过${retries}次尝试后仍无法保存文档`);
}

2. 替换固定休眠为文件状态检查 #

复制模板后不要直接固定休眠15秒，改成循环检查文件是否可正常访问，更高效也更可靠：

const reportFile = DriveApp
  .getFilesByName('Inner Peace Report Template')
  .next()
  .makeCopy(`Inner Peace Report – ${userName}`);

// 等待文件可访问的辅助函数
function waitForFileAccessible(fileId, maxWaitMs = 60000, intervalMs = 2000) {
  const startTime = Date.now();
  while (Date.now() - startTime < maxWaitMs) {
    try {
      DriveApp.getFileById(fileId);
      return;
    } catch (e) {
      Utilities.sleep(intervalMs);
    }
  }
  throw new Error(`文件${fileId}长时间无法访问`);
}

waitForFileAccessible(reportFile.getId());
// 改用openByUrl替代openById，部分场景下稳定性更好
const doc = DocumentApp.openByUrl(reportFile.getUrl());
const body = doc.getBody();

3. 优化PDF导出前的同步验证 #

导出PDF前，检查文档的最后修改时间，确认保存操作已经同步到Drive：

function exportPdfWithRetry(docId, retries = 5, backoffMs = 10000) {
  for (let i = 1; i <= retries; i++) {
    try {
      const file = DriveApp.getFileById(docId);
      const lastModified = file.getLastUpdated();
      const currentTime = new Date();
      // 确保最近5秒内有修改，说明保存已完成同步
      if (currentTime - lastModified < 5000) {
        return exportDocAsPDF(docId);
      }
      Utilities.sleep(backoffMs);
    } catch (e) {
      console.warn(`⚠️ 第${i}次尝试导出PDF失败：${e}`);
      if (i < retries) Utilities.sleep(backoffMs * i);
    }
  }
  throw new Error(`经过${retries}次尝试后仍无法导出PDF`);
}

4. 拆分长流程为异步执行 #

如果OpenAI内容生成耗时特别久，把这部分和文档编辑、PDF导出拆成独立函数，用Google Apps Script的时间驱动触发器异步执行：

1. 先写一个函数调用OpenAI生成内容，保存到Google Sheet或者Drive文件；
2. 再写一个触发器函数，读取保存的内容，编辑文档并导出PDF；
3. 触发第一个函数后，自动触发第二个函数，避免单线程超时。

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