运行4年无改动的Google Sheet脚本突发文档访问错误求助

问题根源分析 #

1. 服务速率限制触发：原脚本在循环中频繁创建临时文档、重复调用DocumentApp.openById()打开同一文档，当处理行数超过6行时，触发了Google Docs服务的调用速率阈值，导致文档访问失败。
2. 代码逻辑错误：脚本中删除临时文档的代码存在明显错误——DriveApp.getFolderById(copyId)里的copyId是文档文件ID，而非文件夹ID，这会导致删除操作失败，临时文档堆积进一步加剧资源占用。
3. 资源复用不足：循环内多次重复打开同一文档实例，未复用已创建的文档对象，额外消耗服务配额。

修复方案 #

1. 修正临时文档删除逻辑

将原错误代码：

DriveApp.getFolderById(copyId).setTrashed(true);

替换为：

DriveApp.getFileById(copyId).setTrashed(true);

2. 优化后的完整代码

function createMergedVouchers() {  
  var activeSheet = SpreadsheetApp.getActive().getSheetByName('Vouchers');
  // 仅读取需要的13列，减少不必要的数据加载
  var activeSelection = activeSheet.getSheetValues(2, 1, activeSheet.getLastRow()-1, 13);
  // 直接提取一维数组，简化后续占位符替换逻辑
  var headerRow = activeSheet.getRange(1, 1, 1, 13).getValues()[0];
  
  var copyFile;
  var copyId;
  var copyDoc;
  var copyBody; 
  
  var base;
  var totalElements;
  var element;
  var type;
    
  for (var rowIndex = 0; rowIndex < activeSelection.length; rowIndex++) {
    // 复制模板文档
    copyFile = DriveApp.getFileById(VOUCHER_ID).makeCopy();
    copyId = copyFile.getId();
    copyDoc = DocumentApp.openById(copyId);
    copyBody = copyDoc.getActiveSection();
    
    // 批量替换占位符，简化代码结构
    for (var col = 1; col <= 12; col++) {
      copyBody.replaceText('%' + headerRow[col] + '%', activeSelection[rowIndex][col] || '');
    }
    // 显式保存并关闭文档，释放服务资源
    copyDoc.saveAndClose();
    
    if (rowIndex === 0) {
      copyDoc.setName('Merged Vouchers');        
      base = copyDoc.getBody();
    } else {
      // 复用已打开的文档对象，避免重复调用openById
      totalElements = copyBody.getNumChildren();      
      for (var elementIndex = 0; elementIndex < totalElements; elementIndex++) {
        element = copyBody.getChild(elementIndex).copy();
        type = element.getType();        
        switch(type) {
          case DocumentApp.ElementType.PARAGRAPH:
            base.appendParagraph(element);
            break;
          case DocumentApp.ElementType.TABLE:
            base.appendTable(element);
            break;
          case DocumentApp.ElementType.LIST_ITEM:
            base.appendListItem(element);
            break;
          default:
            throw new Error("Unknown element type: " + type);
        }        
      }
      // 修正后的临时文档删除逻辑
      DriveApp.getFileById(copyId).setTrashed(true);
    }
    // 添加短延迟，降低服务调用频率（可根据实际情况调整时长）
    Utilities.sleep(500);
  }
  // 最后保存合并后的文档
  if (base) {
    base.getParent().saveAndClose();
  }
}

3. 额外优化说明

• 减少数据读取范围：原代码读取所有列，改为仅读取需要的13列，降低内存占用和处理时间。
• 显式文档管理：调用saveAndClose()主动释放文档服务资源，避免资源泄漏。
• 延迟控制：循环末尾添加500毫秒延迟，避免短时间内大量调用服务触发速率限制。

验证步骤 #

1. 先单独修正临时文档删除的代码，测试处理6行数据是否恢复正常。
2. 应用完整优化代码后，测试处理100-150行数据的场景，确认问题解决。

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