这是一个在 OAuth 2.0 和 OpenID Connect 等授权流程中非常常见的错误，下面我将为您详细解释这个错误的原因、如何排查以及如何解决。
什么是 redirect_uri？
redirect_uri（重定向 URI）是 OAuth 2.0 授权流程中的一个核心参数。
它的作用是：
- 授权起点：用户同意授权后，授权服务器（如 Google, GitHub, 微信等）会将用户的浏览器重定向到这个 URI。
- 接收授权码：在重定向的过程中，授权服务器会通过 URL 参数（通常是
code或state）将一个临时的授权码发送给您的应用。 - 安全验证：它确保授权码只发送给您预先注册的、可信的地址,防止授权码被截获。
redirect_uri 参数错误的具体原因及解决方案
当您遇到 "redirect_uri 参数错误" 时，通常意味着您在请求中提供的 redirect_uri 与您在授权服务商（如 Google Developers Console, 微信开放平台）上注册的 redirect_uri 不匹配。
以下是几种最常见的情况和对应的解决方法：
完全不匹配
原因：
您在代码或请求中使用的 redirect_uri 字符串，与您在服务商后台配置的 任何一个 redirect_uri 都完全不同。
例如：
- 后台配置：
https://myapp.com/auth/callback - 请求中发送：
https://myapp.com/auth/redirect(多了一个 'r')
解决方案：
-
检查服务商后台配置：
- 登录对应的授权服务商平台（如 Google Console, 微信开放平台, GitHub Developer Settings）。
- 找到您的应用，查看“授权回调域”或“重定向 URI”的配置列表。
- 精确复制 这个配置的 URI，确保它包含了协议（
https://或http://）、域名、路径，甚至端口号（如果配置了的话）。
-
检查您的请求代码：
- 在您的应用程序代码中，发起授权请求的地方，找到构建 URL 的部分。
- 确保您使用的
redirect_uri变量值与后台配置的值 100% 一致，包括大小写、空格、特殊字符等。
协议不匹配
原因：
服务商后台配置的是 https://，但您的请求中使用的是 http://，反之亦然，现代安全标准通常强制要求使用 https。
例如：
- 后台配置：
https://myapp.com/callback - 请求中发送：
http://myapp.com/callback
解决方案：
- 统一使用
https协议，如果您的本地开发环境（如localhost）没有 SSL 证书，一些服务商（如 Google）允许在本地开发时使用http://localhost,请查阅具体服务商的文档。
端口不匹配
原因：
当您在本地开发时，使用了非标准的端口号（如 3000, 8080）,但没有在后台配置中包含端口号。
例如：
- 后台配置：
https://localhost:3000/auth/callback(您可能忘记配置端口号) - 请求中发送：
https://localhost:3000/auth/callback(看起来一样,但后台没有这个端口)
解决方案：
- 本地开发：在服务商后台，为您的本地开发环境添加一个新的
redirect_uri，包含您实际使用的端口号，添加http://localhost:3000/auth/callback和https://localhost:3000/auth/callback。 - 生产环境：确保生产环境的
redirect_uri使用的是标准的 80 (http) 或 443 (https) 端口，或者配置了反向代理（如 Nginx）。
路径不匹配
原因：URL 的路径部分不一致。
例如：
- 后台配置：
https://myapp.com/auth/callback - 请求中发送：
https://myapp.com/auth/callback/(末尾多了一个斜杠)
解决方案：
- 确保 URL 路径完全一致，最好在后台配置和代码中都使用不带末尾斜杠的格式。
查询参数不匹配
原因：在 redirect_uri 中添加了额外的查询参数（如 ?source=web），但后台没有配置这个完整的 URI。
例如：
- 后台配置：
https://myapp.com/auth/callback - 请求中发送：
https://myapp.com/auth/callback?source=web
解决方案：
- 最佳实践：
redirect_uri应该是一个固定的、干净的 URL，不应该包含任何动态查询参数，如果需要传递额外信息，请使用state参数。 - 如果确实需要，请在后台配置中添加这个完整的带查询参数的 URI。
如果您遇到这个错误,请按照以下步骤进行排查：
- 复制错误信息：完整地复制服务商返回的错误信息，它通常会指出哪个
redirect_uri是无效的。 - 检查服务商后台：登录到您的应用管理控制台，找到“重定向 URI”或“授权回调域”的设置列表。这是最权威的来源。
- 检查代码：在您的应用代码中，找到发起授权请求的函数，打印出或断点调试，检查您正在使用的
redirect_uri变量的值。 - 逐字符比对：将代码中的值与后台配置的值进行逐字符比对，检查协议、域名、路径、端口号、大小写等是否完全一致。
- 考虑环境：确认您是在本地开发还是生产环境，并确保后台配置了对应环境的正确 URI。
- 查阅官方文档：每个服务商的规则可能略有不同，查阅其官方的 OAuth 2.0 文档是最可靠的方式。
一个简单的例子
假设您正在使用 Google 登录。
-
在 Google Cloud Console 中，您配置的重定向 URI 是：
https://my-awesome-app.com/auth/google/callback -
在您的 Node.js 代码中,您错误地写成了：
const redirectUri = 'https://my-awesome-app.com/auth/google/callback/'; // 注意末尾的斜杠 const authUrl = `https://accounts.google.com/o/oauth2/v2/auth?redirect_uri=${encodeURIComponent(redirectUri)}&...`;这就会导致 "redirect_uri 参数错误"。
-
正确的做法：
- 后台配置：保持
https://my-awesome-app.com/auth/google/callback - 代码修改：将
redirectUri改为https://my-awesome-app.com/auth/google/callback(去掉末尾的斜杠)。
- 后台配置：保持
希望这个详细的解释能帮助您解决问题！
