Google OAuth2授权码模式转换本地Token失败求助

1. 核对请求参数是否符合OAuth2规范 #

调用本地/oauth/token接口走authorization_code模式，必须包含以下必填参数，注意参数名和格式不能错：

• grant_type：固定为authorization_code
• code：Google返回的授权码
• client_id：本地OAuth2服务器配置的客户端ID（别和Google的client_id混淆）
• client_secret：本地OAuth2服务器配置的客户端密钥
• redirect_uri：必须和获取Google授权码时用的地址完全一致（协议、域名、路径全匹配，大小写敏感）

常见错误：

• 误将Google的client_id/secret传给本地接口
• redirect_uri和授权时不一致，比如授权用https://yourdomain.com/google/callback，请求token时写成http://或路径不全
• 参数名拼写错误，比如把code写成authorization_code

2. 检查请求的Content-Type头 #

本地/oauth/token接口一般要求请求为application/x-www-form-urlencoded格式，而非application/json。用curl测试时，要确保用-d传递表单数据，不要用JSON格式提交。

正确curl示例：

curl -X POST \
  http://yourdomain.com/oauth/token \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "grant_type=authorization_code&code=GOOGLE_RETURNED_CODE&client_id=YOUR_LOCAL_CLIENT_ID&client_secret=YOUR_LOCAL_CLIENT_SECRET&redirect_uri=https://yourdomain.com/google/callback"

3. 检查本地OAuth2服务器的客户端配置 #

• 确认客户端已开启authorization_code授权类型，部分服务器默认只支持password模式
• 确认客户端的redirect_uri白名单包含你使用的地址，多数OAuth2服务器会严格校验该参数
• 确认客户端认证方式正确：有些服务器要求通过Basic Auth传递client_id和client_secret（curl需加-u "CLIENT_ID:CLIENT_SECRET"），而非放在表单参数里

4. 查看服务器错误日志 #

500错误的详细原因通常在服务器日志里（比如Laravel的storage/logs、Apache/Nginx的error log），直接看日志能快速定位问题：

• 若日志提示The redirect URI provided is missing or invalid，就是redirect_uri不匹配
• 若提示Client authentication failed，则是client_id/secret错误或认证方式不对

5. 确认授权码的有效性 #

Google返回的授权码只能使用一次，重复调用会提示无效，需重新走Google授权流程获取新code。

6. 排查本地接口的逻辑问题 #

如果是自定义的/oauth/token接口（而非用laravel/passport这类成熟库），要检查代码：

• 是否正确获取了所有必填参数
• 是否对参数做了格式校验（比如code是否为空、grant_type是否合法）
• 是否在参数校验失败时返回400错误，而非抛出未捕获异常导致500

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