You need to enable JavaScript to run this app. 集成Google Drive API的Discord Bot报Token失效、OAuth客户端已删除如何解决
优惠活动
大模型
产品
解决方案
定价
更多

集成Google Drive API的Discord Bot报Token失效、OAuth客户端已删除如何解决

Google Drive API 自托管Bot RefreshError 排查方案

报错根因梳理

两类报错的触发逻辑是连贯的,和你之前单独替换client_secret.json的操作没有冲突,核心问题出在授权token的缓存机制上:

  • 首次触发的invalid_grant: Token has been expired or revoked:两个高概率触发原因
    • 你当前GCP项目的OAuth应用处于测试发布状态时,测试用户绑定的refresh_token默认有效期只有7天,完全匹配你稳定运行一周后触发报错的时间规律
    • 代码中加载了本地持久化存储的旧授权token,服务端校验时发现token已过期或被Google主动吊销
  • 替换新建项目的凭证后触发的deleted_client: The OAuth client was deleted:你删除旧GCP项目里的OAuth客户端后,代码依然在读取本地缓存的、绑定旧client_id的token文件,Google服务端识别到对应的OAuth客户端已被删除,直接返回该报错

可落地操作步骤

  • 清空服务器上所有授权流程生成的本地缓存文件。定位代码中授权逻辑指定的token存储路径(常见文件名为token.json、drive_v3_token.json),全部删除,彻底排除旧缓存对新凭证流程的干扰
  • 校验当前使用的client_secret.json有效性。确认文件对应的OAuth 2.0客户端是当前GCP项目中未被删除的有效凭证,凭证类型选择“桌面应用”即可适配自托管Bot的无交互运行场景
  • 重新生成匹配新凭证的token对。由于你的Bot运行在无图形界面的Web托管服务器上,无法直接完成浏览器跳转授权:
    • 可在本地有图形界面的环境下运行一次初始化授权代码,授权完成后将生成的新token缓存文件上传到服务器的对应存储路径即可
    • 授权前提前将使用的Google账号添加到GCP项目OAuth应用的“测试用户”列表中,避免授权环节被权限拦截
  • 长期运行稳定性配置。为避免后续反复出现token过期问题,选择以下任一方案即可:
    • 将GCP项目中的OAuth应用从测试状态发布为生产状态,取消测试场景下refresh_token的7天有效期限制
    • 改用服务账号凭证调用Google Drive API,不需要交互式授权和定期刷新token,更适合无交互的自托管服务场景

常见踩坑提醒

  • client_id、client_secret、refresh_token三者是强绑定关系,只要任意一个参数发生变更,旧的缓存token就完全失效,必须重新走完整授权流程生成新的匹配对,单独替换client_secret.json无法解决刷新报错
  • 定期核对服务器的系统时间,避免时间偏差超过5分钟,这类时间不同步的问题也会触发Google接口的token校验失败
  • 确认授权使用的Google账号对目标Drive文件夹有读取权限,排除权限缺失导致的间接报错

内容的提问来源于stack exchange,提问作者hongyeezus

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.06 13:54:03