Google Script通过google.script.run调用服务端函数执行失败咨询

常见故障原因 #

• Google Apps Script权限规则更新：近期谷歌调整了已部署脚本的跨上下文调用权限策略，此前有效的脚本授权可能自动过期，若脚本所在Google Workspace组织近期调整了第三方应用限制规则，也会触发无报错的调用失败
• 调用身份与部署配置不匹配：如果表单对外开放访问，但脚本部署时执行身份设置为仅所有者可执行，访客身份调用时无权限触发服务端函数，默认仅返回Failed状态无具体报错
• 部署版本未同步：脚本编辑器中修改的是草稿版本，前端调用的是之前发布的稳定版本，未同步更新的场景下会出现函数不存在、逻辑不匹配的问题
• 浏览器环境拦截：广告拦截类扩展、多谷歌账号登录导致的会话冲突，会拦截google.script.run的请求，触发无提示失败

排查解决步骤 #

• 第一步：补全前端错误捕获逻辑，拿到具体报错信息。修改前端触发函数如下：

function TestClick(){
  google.script.run
    .withFailureHandler(err => {
      // 浏览器控制台（F12）可查看完整报错
      console.error('调用失败详情：', err);
    })
    .test();
}

修改后打开浏览器控制台，点击按钮即可查看具体错误类型，例如权限错误、函数不存在等。

• 第二步：核对脚本部署配置。打开脚本编辑器右上角「部署」-「管理部署」，确认两项配置：执行身份如果需要对外开放调用，可选择以我（脚本所有者）的身份执行，访问权限根据场景设置为「任何人」或「组织内所有人」，配置完成后保存。
• 第三步：重新授权并发布新版本。先移除谷歌账号中该脚本的原有授权（路径：谷歌账号「安全」-「第三方应用和账号连接」，找到对应脚本移除访问权限），回到脚本编辑器手动运行一次服务端test函数，触发授权流程完成授权后，新建一个部署版本，使用新部署的URL测试功能。
• 第四步：排查浏览器环境冲突。关闭所有浏览器扩展，使用无痕模式仅登录对应脚本所有者的单个谷歌账号，重新访问表单测试功能。
• 第五步：确认组织策略限制。如果使用的是企业版Google Workspace账号，联系管理员确认是否近期调整了Apps Script运行限制、外部应用调用权限规则。

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