Google Doc Apps Script出现Exception: Service unavailable: Documents错误求助

问题描述 #

此前正常运行数月的Google Doc Apps Script，近期调用addPositionedImage()插入Blob格式图片（无论是通过URL Fetch还是getFileById获取）时，持续触发错误：Exception: Service unavailable: Documents。简化后的复现代码如下：

function debugProc () {
  var rLlogoborderlessId = '1ZhOX_aneaAhM0XJV4oQHGfNPUzaVETgu';
  doc = DocumentApp.getActiveDocument();
  curBody = doc.getBody();
  var addlines = curBody.appendParagraph('');
  var imgpara = curBody.appendParagraph("");
  imgpara.setAlignment(DocumentApp.HorizontalAlignment.CENTER);
  var logoimage = DriveApp.getFileById(rLlogoborderlessId).getBlob();
  var addlineslogo = curBody.appendParagraph('');
  var k2nplogo = addlineslogo.addPositionedImage(logoimage);
  // Error:  Exception: Service unavailable: Documents
}

可行解决方案 #

1. 先确认Google Workspace服务状态 #

直接查看Google官方的Workspace服务状态页面，检查Documents服务是否存在临时故障或维护。如果是官方服务 outage，无需操作，等待服务恢复即可——这类临时波动偶尔会针对特定API功能发生。

2. 切换图片插入的编码格式 #

尝试将Blob转换为Base64字符串后再传入addPositionedImage()，部分场景下能规避Blob传输的服务异常：

function debugProc() {
  var rLlogoborderlessId = '1ZhOX_aneaAhM0XJV4oQHGfNPUzaVETgu';
  var doc = DocumentApp.getActiveDocument();
  var curBody = doc.getBody();
  var addlineslogo = curBody.appendParagraph('');
  
  // 将Blob转为Base64编码字符串
  var logoBlob = DriveApp.getFileById(rLlogoborderlessId).getBlob();
  var base64Image = logoBlob.getContentType() + ';base64,' + Utilities.base64Encode(logoBlob.getBytes());
  
  var k2nplogo = addlineslogo.addPositionedImage(base64Image);
}

3. 添加临时重试机制 #

如果是服务端的瞬时波动，加个简单的重试逻辑能提高成功率：

function debugProc() {
  var rLlogoborderlessId = '1ZhOX_aneaAhM0XJV4oQHGfNPUzaVETgu';
  var doc = DocumentApp.getActiveDocument();
  var curBody = doc.getBody();
  var addlineslogo = curBody.appendParagraph('');
  var logoBlob = DriveApp.getFileById(rLlogoborderlessId).getBlob();
  
  const maxRetries = 3;
  let retryCount = 0;
  let success = false;
  
  while (retryCount < maxRetries && !success) {
    try {
      var k2nplogo = addlineslogo.addPositionedImage(logoBlob);
      success = true;
    } catch (e) {
      retryCount++;
      if (retryCount >= maxRetries) throw e;
      // 重试前等待1秒，避免频繁请求触发限制
      Utilities.sleep(1000);
    }
  }
}

4. 验证权限与文件可用性 #

• 确认脚本拥有Drive和Documents的完整权限：在Apps Script编辑器中依次点击「运行>授权」，重新授权并检查权限范围。
• 检查目标图片文件：确认文件未被删除、移动，且已共享给脚本运行账号（或设置为公开可访问）。

5. 提交官方反馈 #

如果以上方法均无效，直接在Apps Script编辑器内提交问题反馈：点击「帮助>报告问题」，附上你的简化代码、错误日志、运行环境（如Workspace版本、账号类型），让Google工程师排查是否为API层面的专属bug。

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