OAuth2 授权码模式回调 redirect_uri 不匹配报错怎么处理？

遇到 OAuth2 授权码模式回调 redirect_uri 不匹配报错，核心原因是请求参数与后台注册地址不一致。直接检查授权平台后台配置的回调地址与你代码中发起请求时带的 redirect_uri 参数是否完全一致，包括协议、域名、端口和路径。

先说结论：redirect_uri 必须严格匹配，任何字符差异都会导致授权服务器拒绝请求，这是协议强制的安全要求。

先确认：登录 OAuth 提供商控制台，查看已注册的回调地址列表。
先处理：修改代码中的请求参数或后台配置，确保两者字符串完全相同。
再验证：重新发起授权请求，观察是否仍返回 invalid_redirect_uri 错误。

使用浏览器开发者工具排查请求

这类问题主要在于核对配置和代码，必要时可通过服务器日志或命令行工具辅助排查。在浏览器端，你可以直接捕获实际发出的请求 URL：

按 F12 打开开发者工具，切换到 Network（网络） 面板。
勾选 Preserve log（保留日志），防止跳转后日志清除。
点击页面的“登录”或“授权”按钮。
在列表中找到指向授权服务器（如 github.com/login/oauth/authorize）的请求。
点击该请求，查看 Query String Parameters 或 Request URL，复制其中的 redirect_uri 值。
将该值与后台配置的地址逐字符比对。

主流平台配置路径示例

不同提供商的配置入口不同，以下是常见平台的路径参考：

GitHub：Settings -> Developer settings -> OAuth Apps -> 选择应用 -> Callback URL。
Google：APIs & Services -> Credentials -> 选择 OAuth 2.0 Client ID -> Authorized redirect URIs。
Auth0：Applications -> 选择应用 -> Settings -> Allowed Callback URLs。

注意：部分平台支持配置多个回调地址，确保请求时用的是列表中的某一个，而不是列表外的地址。

服务端错误日志分析

如果浏览器跳转后直接显示错误页，查看应用服务端日志能提供更具体的错误码。典型的 OAuth2 错误日志如下：

[ERROR] OAuth2 Authorization Error: invalid_redirect_uri
[DETAIL] Provided redirect_uri 'http://localhost:8080/callback' does not match registered URIs.

日志中通常会明确指出不匹配的具体值，方便你定位是协议头、端口还是路径末尾斜杠的问题。

常见坑与验证方法

修改完成后，清除浏览器缓存或打开无痕窗口，重新点击“登录”或“授权”按钮。如果配置正确，页面会跳转到授权确认页，而不是直接报错。你也可以查看应用服务器的日志，确认是否收到了回调请求并获取到了 code 参数。

除了浏览器测试，服务端也可用 curl 模拟请求验证（注意替换 client_id 和 scope）：

curl -v "https://provider.com/oauth/authorize?response_type=code&client_id=YOUR_ID&redirect_uri=https://yourdomain.com/callback&scope=read"

常见配置陷阱：

HTTP 与 HTTPS 混用：后台配置了 HTTPS，代码请求用了 HTTP，会被判定为不匹配。
localhost 与 127.0.0.1：这两个在网络上等价，但在字符串比对中不相等。
尾部斜杠：http://example.com/callback 和 http://example.com/callback/ 被视为不同的地址。
动态拼接错误：有些框架会自动添加端口号或路径，导致最终发出的 URI 与配置不符。

参考来源

IETF RFC 6749 - The OAuth 2.0 Authorization Framework, Section 3.1.2 Redirect URI
URL: https://datatracker.ietf.org/doc/html/rfc6749