Workspace插件中App Script触发“超出最大执行时间”报错排查

• 确认函数触发方式
  检查是否通过单元格自定义函数调用（比如在Sheet单元格输入=runFor6Min()），这种场景哪怕函数逻辑简单，也会遵循自定义函数的30秒（实际可能浮动至45秒）超时规则，只有通过脚本编辑器「运行」按钮、时间/事件触发器、API调用等方式执行，才会应用6分钟的Script runtime配额。

• 校验appsscript.json配置

  • 查看runtimeVersion是否设置为V8，旧版运行时的超时规则可能存在差异
  • 确认oauthScopes配置正常，异常的权限声明可能导致运行环境切换到受限模式
  • 检查是否开启了Execution API，若启用需确认该API的配额是否被单独限制

• 验证执行上下文
  在函数开头添加日志代码，执行后查看日志确认运行时类型：

  console.log('运行上下文类型:', ScriptApp.getAuthorizationInfo(ScriptApp.AuthMode.FULL).runtimeType);
  

  同时排查是否有隐藏的自动执行代码（如onOpen、onEdit），这类代码可能在主函数运行前消耗时间，导致总时长提前触发超时。

• 测试全新空白项目
  创建一个完全空白的脚本项目，仅保留以下测试代码：

  function runFor6Min() {
    console.log('开始时间:', new Date());
    Utilities.sleep(360000); // 6分钟
    console.log('结束时间:', new Date());
  }
  

  通过脚本编辑器直接运行，观察是否触发超时，以此排除原项目的配置污染问题。

• 检查账户配额状态
  确认当前账户是否存在自定义配额限制（部分G Suite教育版/企业版可能有特殊配置），查看对应项目的配额使用情况，排除账户级别的超时限制。

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