解决 OAuth2.0 授权码模式 redirect_uri_mismatch 报错的核心是确保请求中的回调地址与授权服务器控制台注册的地址完全一致。该问题通常由协议、端口、路径大小写或末尾斜杠的微小差异引起，需严格按照 RFC 6749 标准进行字节级比对修复。

快速处理思路

若无命令行环境，可通过以下配置检查快速定位：

1. 打开授权提供商控制台（如 Google Cloud Console、GitHub Developer Settings）。
2. 复制已注册的回调地址到文本编辑器。
3. 在本地代码或配置文件中搜索该地址，逐字符比对差异。

为什么会这样

OAuth2.0 协议规范 RFC 6749 第 3.1.2 节明确规定重定向端点 URI 必须与注册值完全匹配（exactly）。

授权服务器在校验时执行字节级（byte-for-byte）相等比较，而非语义相等。这意味着 https://example.com/callback 与 https://example.com/callback/ 被视为不同地址，路径中的大小写字母（如 /Auth 与 /auth）也被视为不同字符。部分提供商如 Google 严格遵循此标准，任何细微差别都会触发 invalid_redirect_uri 异常。

分步处理

按以下顺序排查配置与代码：

1. 核对控制台注册信息

登录授权提供商后台，找到 OAuth Client ID 配置页。检查 Authorized redirect URIs 列表，确认是否包含当前环境所需的地址。若本地开发使用 http://localhost:3000/callback，必须显式注册该地址，不能复用生产环境的 https 域名。

2. 检查代码构造逻辑

查看后端或前端代码中生成授权请求链接的部分。确保 redirect_uri 参数是硬编码或通过环境变量注入，避免动态拼接导致路径波动。若使用 Spring Security 等框架，检查 server.servlet.context-path 和 server.port 配置是否与预期一致。

3. 排查代理与转发头

若应用部署在 Nginx 或负载均衡后，检查是否配置了 X-Forwarded-Proto 和 X-Forwarded-Port 头。后端框架可能依据这些头动态生成回调地址，若代理层未正确传递协议或端口，会导致生成的 URI 与注册值不符。

怎么验证是否生效

修改配置后，通过以下方式验证修复结果：

• 浏览器抓包：打开开发者工具 Network 面板，发起授权请求，查看跳转至授权服务器（如 accounts.google.com）的请求参数中 redirect_uri 的值。
• 后端日志：观察应用启动日志或请求日志，确认 OAuth2 客户端初始化时加载的 redirect_uri 是否符合预期。
• 授权流程：重新发起登录，若不再出现 400 错误页面且能成功跳转回应用，则修复生效。

常见坑

• 末尾斜杠：http://example.com/callback 与 http://example.com/callback/ 不匹配，需统一是否保留斜杠。
• 端口号：显式声明的端口（如 :8080）与默认端口（https 默认为 443）被视为不同，注册时需包含端口号。
• 大小写敏感：路径部分区分大小写，建议统一使用小写字母避免歧义。
• 协议差异：开发环境 http 与生产环境 https 需分别注册，不可混用。

常见问题

查询参数会影响匹配吗？

基础 URI 验证通常不包含查询参数，但部分严格模式可能要求完全一致。

本地 localhost 地址需要注册吗？

需要，localhost 与正式域名视为不同地址，必须在控制台单独添加。

路径大小写不一致会报错吗？

会，Google 等提供商严格按 RFC 6749 执行字节级匹配，大小写差异直接导致失败。

参考来源

• CSDN 问：Yudao OAuth2.0 中如何解决授权码模式下 redirect_uri 不匹配问题？
• Google OAuth 技术文档：OAuth2 回调报 redirect_uri_mismatch 是大小写的问题吗？
• 技术博客：Google OAuth redirect_uri_mismatch 根本原因与调试地图
• 技术博客：避开这些坑！Google OAuth2.0 授权登录的 5 个常见错误及解决方案
• GitHub 文档：GitHub OAuth 2.0 回调 URL 不匹配如何解决？
• 若依框架文档：若依框架集成 Google 登录时 OAuth2 回调地址配置错误如何解决？
• 技术博客：Google OAuth redirect_uri_mismatch 错误排查与解决指南
• 技术博客：避坑指南:Google OAuth 2.0 配置中的'redirect_uri_mismatch'等 5 个常见错误及解决方法
• RFC 6749 规范：OAuth 授权 URL 中 redirect_uri 不匹配导致授权失败如何解决？
• Java SDK 文档：别再被 Google OAuth2.0 的 redirect_uri_mismatch 搞懵了！手把手教你用 Java SDK(含 LocalServerReceiver 配置)