Google Apps Script随机报错‘Not found’排查咨询

第一步：解决日志为空的问题 #

日志是排查核心，先确保能捕获到错误细节：

• 手动添加关键节点日志：在HTTP请求、Sheet读写、邮件发送等操作的前后，插入带时间戳的日志，记录操作类型和核心参数。示例：

  console.log(new Date().toISOString() + " 准备调用API，URL：" + apiUrl);
  

• 用try-catch包裹风险代码块：在所有可能抛出错误的逻辑外添加捕获，打印完整错误信息（包括堆栈）。示例：

  try {
    const sheet = SpreadsheetApp.openById(sheetId);
  } catch (e) {
    console.error(new Date().toISOString() + " 打开Sheet失败：", e.message, e.stack);
  }
  

• 备份日志到Sheet：由于官方日志有存储限制，可将关键日志写入专门的日志Sheet，避免旧日志被清理。

第二步：针对"Not found"错误的模块排查 #

"Not found"通常指向资源不存在，分模块逐一验证：

Google Sheet模块 #

• 确认Sheet ID的有效性：检查是否有动态获取ID的逻辑（比如从单元格读取），避免读取到无效值；固定ID的话，确认Sheet未被重命名、移动或删除。
• 验证范围引用：检查getRange()的参数是否存在动态计算错误，比如引用了不存在的行/列，或空单元格导致的无效范围。
• 检查权限：确认脚本运行账号对目标Sheet有编辑/查看权限，避免共享权限被取消导致的访问失败。

HTTP请求API模块 #

• 校验请求URL：若URL是动态拼接的（比如从Sheet读取），检查拼接逻辑是否会生成无效地址；固定URL的话，手动访问确认API服务正常。
• 记录响应细节：在请求时捕获响应状态码和内容，确认是否是API返回404，还是请求过程中出现的资源找不到。
• 验证请求参数：检查token、签名等动态参数是否过期或格式错误，尤其是依赖时间戳的参数是否存在时区偏差。

邮件发送模块 #

• 确认收件人地址：若邮箱是从Sheet读取的，检查是否存在无效格式的邮箱；固定邮箱的话，验证收件人账号是否正常（未注销、未拉黑）。
• 检查邮件服务配额：Google Apps Script有每日发送邮件配额，确认是否触发限制导致发送失败，被系统返回"Not found"类提示。

第三步：排查环境与触发因素 #

• 检查触发方式：若为时间驱动触发，核对触发时间段是否与API/Sheet的维护窗口重合；若为手动触发，记录触发时的操作场景。
• 验证账号权限：确认脚本运行账号未发生权限变更（比如密码修改、二次验证开启），避免权限失效导致的资源访问失败。
• 模拟复现：手动输入不同的测试数据（比如异常Sheet内容、特殊API参数），尝试复现故障，定位触发条件。

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