Keycloak 16.1.1注册后重定向至应用失败问题求助

问题根源 #

你的错误来自两个核心问题：

1. sed命令修改错误：你把注册表单的id改成了kc-form-login，action改成了${url.loginAction}，相当于把注册表单改成了登录表单，提交到了登录接口，这和注册流程的会话上下文不匹配，直接导致登录超时提示。
2. 硬编码redirect_uri的方式不合理：硬编码固定地址会丢失从应用跳转过来时携带的原始redirect参数，同时如果该地址未配置在客户端的有效重定向URI列表中，也会被Keycloak拦截。

正确解决步骤 #

1. 修正模板修改（优先用内置变量传递redirect_uri） #

Keycloak在跳转至注册页面时，已经携带了从应用过来的redirect_uri参数，并存储在${url.encodedRedirectUri}变量中。你只需要把这个参数追加到注册表单的action后即可，不需要硬编码地址。

执行正确的sed命令：

sed -i 's|<form id="kc-register-form" class="${properties.kcFormClass!}" action="${url.registrationAction}" method="post">|<form id="kc-register-form" class="${properties.kcFormClass!}" action="${url.registrationAction}${(url.encodedRedirectUri != "") ? \"?\" url.encodedRedirectUri : \"\"}" method="post">|' /opt/jboss/keycloak/themes/base/login/register.ftl

2. 确保客户端重定向URI配置正确 #

在Keycloak控制台的对应客户端设置中，把你的应用地址添加到Valid Redirect URIs列表里，比如http://my_application_endpoint/*，否则Keycloak会拒绝重定向请求。

3. 推荐：使用自定义主题而非修改base主题 #

直接修改base主题会在Keycloak升级时被覆盖，建议创建自定义主题继承base：

• 在容器内创建自定义主题目录：

  mkdir -p /opt/jboss/keycloak/themes/my-theme/login
  

• 复制base主题的register.ftl到自定义目录：

  cp /opt/jboss/keycloak/themes/base/login/register.ftl /opt/jboss/keycloak/themes/my-theme/login/
  

• 修改自定义主题下的register.ftl（用步骤1的方式）
• 在Keycloak控制台中，将对应客户端的Login Theme设置为my-theme

4. 验证流程 #

重启容器后，从你的应用跳转至注册页面，完成注册后应该会自动重定向回应用。如果仍有问题，检查Keycloak日志，查看是否有重定向URI不允许的报错。

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