You need to enable JavaScript to run this app. 使用GitHub OAuth2换取access token时出现bad_verification_code错误的问题
优惠活动
大模型
产品
解决方案
定价
更多

使用GitHub OAuth2换取access token时出现bad_verification_code错误的问题

GitHub OAuth兑换Access Token报bad_verification_code问题排查

你提供的curl命令存在的可直接修正的问题

  • 请求头冗余夹带了网页端会话Cookie:调用token兑换接口是服务端到服务端的纯凭证交换流程,完全不需要携带你个人GitHub网页端的user_session类身份Cookie,这类无关请求头可能触发接口校验逻辑异常,直接删除对应的Cookie请求头即可。
  • 请求参数冗余传入了state字段:state是你自己服务端做CSRF防护的校验值,根本不需要提交给GitHub的兑换接口,官方兑换接口的参数列表中也不存在该字段,属于无效传参。

核心报错诱因排查方向

  • 授权码使用规则限制:GitHub签发的authorization code有效期仅10分钟,且仅支持单次使用——只要你之前已经用这个code发起过哪怕一次兑换请求(不管那次请求是否成功),这个授权码就会立刻作废,后续再拿同一个code调用接口必然返回bad_verification_code。遇到这类情况需要重新走完整授权流程,拿到全新的授权码后在有效期内一次性发起兑换。
  • 关键参数一致性校验:
    • 确认client_id、client_secret和你在GitHub注册的OAuth应用信息完全匹配,没有错配其他应用的凭证
    • 确认redirect_uri和你最开始引导用户发起授权请求时携带的回调地址完全一致,任何字符差异(比如末尾多/少斜杠、端口不匹配、路径大小写不同)都会触发校验失败
  • 补充说明:grant_type字段传或不传都能被GitHub接口正常识别,不属于本次报错的诱因。

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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.11.08 03:36:10