Google OAuth2集成:请求token时redirect_uri报Missing scheme错误
提问原文
尽管我在StackOverflow上查阅了大量同类重复问题,仍始终无法弄清楚自己的操作哪里出错了。
问题:我已成功获取授权码,但使用该code请求access token时返回如下错误:
{ "error": "invalid_request", "error_description": "Invalid parameter value for redirect_uri: Missing scheme: http%3A%2F%2Flocalhost%3A3030%2Fgoogle%2Foauth2%2Fcallback" }
配置信息:
- 我使用的回调URL为
http://localhost:3030/google/oauth2/callback - 该回调地址已在Google开发者控制台完成配置
- 我用于获取token的原始curl请求如下:
curl --location --request POST 'https://oauth2.googleapis.com/token' \ --header 'Content-Type: application/x-www-form-urlencoded' \ --data-urlencode 'code=4%2F0AY0e-g6zyewnsWjPEXoxZWawsp1E634ZlefYoBeYO1nXxBwjPQNCGVf7SGb4MxfNcjUApw' \ --data-urlencode 'redirect_uri=http%3A%2F%2Flocalhost%3A3030%2Fgoogle%2Foauth2%2Fcallback' \ --data-urlencode 'client_id=....' \ --data-urlencode 'client_secret=....' \ --data-urlencode 'grant_type=authorization_code'
注:我已对包含斜杠的redirect_url和code做了URL编码。为统一处理,我也尝试对client_id、client_secret和grant_type做编码,因这些参数仅含ASCII字符,编码结果无变化。
已执行的排查操作:
- 查阅了大量StackOverflow上的同类报错问题
- 尝试了多种redirect_uri配置变体:
http://localhost/google/oauth2/callback:3030http://127.0.0.1:3030/google/oauth2/callbackhttp://127.0.0.1/google/oauth2/callback:3000
以上配置均未生效。
- 通读了Google官方OAuth2文档
- 测试了OAuth2 Playground,该场景下流程可正常运行,但我的实现仍无法正常运行
- 尝试了多种请求体格式及不同Content-Type配置,仍遇到相同问题,部分场景下还会返回如下错误:
{ "error": "invalid_grant", "error_description": "Bad Request" }
问题解决
核心报错原因
你犯了两处双重编码错误:
redirect_uri手动做了一次URL编码后,再传给curl的--data-urlencode参数,工具本身会自动对参数值做URL编码,导致原本编码用的%符号被二次转义为%25,最终发送到Google服务器的redirect_uri值为http%253A%252F%252Flocalhost%253A3030...,服务器无法识别开头的HTTP协议头,直接抛出"Missing scheme"错误- 授权码
code也手动做了一次URL编码(把斜杠/转成了%2F),同样被二次转义,导致服务器无法正确解析授权码格式,后续就会触发invalid_grant类的报错
修复后的请求写法
不需要提前手动对参数做URL编码,直接传原始明文值即可,--data-urlencode会自动处理需要转义的特殊字符,正确的curl命令如下:
curl --location --request POST 'https://oauth2.googleapis.com/token' \ --header 'Content-Type: application/x-www-form-urlencoded' \ --data-urlencode 'code=4/0AY0e-g6zyewnsWjPEXoxZWawsp1E634ZlefYoBeYO1nXxBwjPQNCGVf7SGb4MxfNcjUApw' \ --data-urlencode 'redirect_uri=http://localhost:3030/google/oauth2/callback' \ --data-urlencode 'client_id=你的实际client_id值' \ --data-urlencode 'client_secret=你的实际client_secret值' \ --data-urlencode 'grant_type=authorization_code'
后续排查要点
- 授权码是一次性、短期有效的,之前测试流程中已经用过的授权码不能重复使用,每次测试要重新走授权流程拿新码
- 拿授权码时跳转用的redirect_uri,和换token时提交的redirect_uri必须完全一致,哪怕末尾多一个斜杠、少一个斜杠都会校验失败
- 不要使用不符合URL规范的写法(比如把端口拼在路径末尾
http://xxx.com/path:port),全程用标准格式协议://域名:端口/路径即可 - 明确区分
localhost和127.0.0.1是两个完全不同的回调配置,从拿授权码到换token的全流程里,统一用其中一种地址,不要混用 - 确认Google开发者控制台里配置的回调URI和你实际提交的地址一字不差
内容的提问来源于stack exchange,提问作者skryvets
相关产品推荐
相关产品推荐

