使用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
相关产品推荐
相关产品推荐

