Keycloak UI用户注册报错：Invalid username or password求助

问题详情 #

• 已在Keycloak管理面板开启目标领域keycloak-react-auth的用户注册功能
• 使用未重复的邮箱和用户名提交注册请求后，页面返回「Invalid username or password」错误
• 控制台输出日志：

2023-01-06 00:39:50 2023-01-05 23:39:50,440 WARN  [org.keycloak.events] (executor-thread-34) type=REGISTER_ERROR, realmId=keycloak-react-auth, clientId=account-console, userId=null, ipAddress=172.17.0.1, error=invalid_user_credentials, auth_method=openid-connect, auth_type=code, redirect_uri=http://localhost:8080/realms/keycloak-react-auth/account/#/,, code_id=c8dccb6d-1ca4-4f25-b160-9b72d48bffd1, authSessionParentId=c8dccb6d-1ca4-4f25-b160-9b72d48bffd1, authSessionTabId=gY0TRMYd8aw

原因分析 #

日志中error=invalid_user_credentials表明注册流程意外触发了登录凭证校验逻辑，通常由以下场景导致：

• 密码不符合当前领域的密码策略，但错误提示被异常覆盖
• 注册流程的认证执行步骤配置错误，混入了登录验证环节
• 用户存储提供商（如自定义存储、LDAP）存在创建用户的权限或逻辑问题

排查与修复步骤 #

1. 验证密码策略合规性
   进入Keycloak管理面板，切换到keycloak-react-auth领域，依次点击「Authentication」→「Password Policy」，检查注册时输入的密码是否满足所有配置规则（如长度、特殊字符、大小写组合要求）。

2. 检查注册流程配置
   进入「Authentication」→「Flows」，找到「Registration」流程，确认流程中仅包含注册相关执行步骤（如「Registration Form」「Recaptcha」等），避免误添加「Username Password Form」这类登录校验步骤。

3. 排查用户存储配置
   如果使用了非内置的用户存储（如LDAP、自定义SPI），确认存储提供商允许创建新用户，且用户名/邮箱唯一性检测逻辑正常，未出现异常拦截。

4. 清除浏览器会话信息
   清除当前浏览器的缓存与Cookie后，重新打开注册页面尝试提交，避免残留的登录会话干扰注册流程。

5. 开启详细日志定位问题
   将Keycloak日志级别调整为DEBUG，获取更完整的错误堆栈：

   # 针对Quarkus版本，修改keycloak.conf
   log-level=org.keycloak=DEBUG
   
   # 针对WildFly版本，修改standalone.xml
   <logger category="org.keycloak">
       <level name="DEBUG"/>
   </logger>
   

   重启Keycloak后重新触发注册，通过详细日志定位具体错误触发点。

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