无法解决Google File Picker服务器端ScriptError问题

我之前也碰到过这种头疼的服务器错误，明明照着文档一步步来还是卡壳，除了你已经排查的密钥、权限、清单这些点，还有几个容易被忽略的方向可以试试：

• OAuth客户端ID的配置细节
  别只盯着ID是否正确，这些细节也不能漏：

  • 确认客户端ID对应的应用类型是「Web应用」，选桌面应用或其他类型会直接触发权限验证失败。
  • 在OAuth同意屏幕里，务必把插件关联的Google Workspace域名（企业插件场景）或测试用户添加进去。未发布的插件只有指定测试用户能正常调用，否则会被服务器拦截。
  • 重定向URI必须严格匹配：https://script.google.com/macros/d/{你的脚本ID}/usercallback，替换成你自己的脚本ID，多一个少一个字符都不行。

• 文件选择器初始化代码的隐性疏漏
  代码里的小细节很容易引发服务器端报错：

  • 确认google.picker.PickerBuilder()的setDeveloperKey用的是API密钥，别和OAuth客户端ID搞混，这俩经常被误用。
  • setOAuthToken里必须传入ScriptApp.getOAuthToken()获取的令牌，不能硬编码或用其他来源的令牌。
  • 如果插件绑定在Docs/Sheets等文档中，setOrigin必须设为google.script.run.origin，这个参数和当前文档上下文绑定，错了会触发跨域类的服务器错误。

• API服务的启用与限制检查
  除了启用Google Picker API，还要注意：

  • 确认脚本关联的Google Cloud项目（如果用了自定义项目而非默认项目）已经启用该API，很多人会在默认项目启用，但脚本实际用的是自定义项目，导致调用失败。
  • 检查API密钥的限制：别给API密钥设置IP限制（测试阶段），也确保只允许Google Picker API调用，避免其他API的干扰。

• 权限与清单文件的隐性冲突
  权限范围看似没问题，但可能有隐藏冲突：

  • 清单文件oauthScopes必须包含https://www.googleapis.com/auth/script.container.ui和你需要的Drive权限（比如https://www.googleapis.com/auth/drive.file），权限不全会导致服务器静默报错。
  • 若近期修改过权限范围，务必重新授权插件——手动重新打开插件触发授权流程，旧的权限令牌会导致服务器验证失败。

• 缓存与脚本环境问题

  • 试试重新部署插件，哪怕只是改个小细节再部署，旧部署的缓存可能引发奇怪的服务器错误。
  • 换浏览器或用隐身模式测试，浏览器缓存的旧OAuth令牌可能干扰验证流程。
  • 查看脚本执行日志（编辑器「查看」→「日志」），有时候服务器错误会有更详细的日志（比如具体API错误码），而非只显示通用报错。

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