Keycloak 24.0.2：Invalid parameter: redirect_uri 问题求助

可能的原因及解决步骤 #

1. 确认Valid redirect URIs的配置规则 #

Keycloak的通配符仅允许用在路径的末尾，配置时不要加引号。你设置的http://localhost:8080/*是合法格式，但要注意：

• 请求中的redirect_uri必须和配置的协议、域名、端口完全一致（比如不能用https代替http，端口不能写错）
• 通配符仅匹配该路径下的所有子路径，比如http://localhost:8080/app、http://localhost:8080/app/login都符合规则，但http://localhost:8081/*或https://localhost:8080/*会被判定无效

2. 检查客户端配置细节 #

• 多URI需分行配置：如果要添加多个Valid redirect URIs（比如http://localhost:8080/*和http://www.google.com/*），要每行写一个，不要在同一行用逗号分隔。
• 校验Base URL设置：如果客户端配置了「Base URL」，Keycloak会强制redirect_uri以该Base URL开头。比如Base URL设为http://localhost:8081，那http://localhost:8080/*肯定不匹配，需要把Base URL改成http://localhost:8080或者留空。
• 检查Strict Redirect URI选项：在客户端的「Advanced」标签里，若开启了「Strict Redirect URI」，会严格校验redirect_uri是否匹配配置项。如果通配符配置正确，这个选项不影响，但如果配置有误，会直接触发报错。

3. 核对请求中的redirect_uri参数 #

打开Postman的请求详情，确认redirect_uri的实际值：

• 有没有拼写错误、额外路径或参数？比如实际请求的是http://localhost:8080（无末尾斜杠），理论上http://localhost:8080/*应该匹配，但可以尝试在配置里同时添加http://localhost:8080/*和http://localhost:8080两行，覆盖这种边界情况。
• 有没有URL编码问题？比如redirect_uri被错误编码成http%3A%2F%2Flocalhost%3A8080%2F*，这种情况需确保参数是原始未编码值（Keycloak会自动处理编码，手动编码可能导致匹配失败）。

4. 测试验证步骤 #

1. 先简化配置：把Valid redirect URIs临时改成http://localhost:8080，请求中redirect_uri也用这个值，看是否能正常跳转。如果可以，说明通配符的使用或实际请求的URI存在问题。
2. 逐步恢复通配符：改成http://localhost:8080/*，用http://localhost:8080/test作为redirect_uri发起请求，验证是否有效。
3. 清除缓存：修改Keycloak配置后，可能需要等待几秒生效，或者清除浏览器/Postman的缓存后重新请求。

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