Keycloak quay.io最新镜像禁用Registration User Profile Creation流程后注册失败

问题根源 #

你遇到的NullPointerException是因为禁用了“Registration User Profile Creation”这个核心流程步骤，导致Keycloak在注册流程中无法创建UserModel实例，但后续流程仍尝试调用user.addRequiredAction()方法，直接触发空指针异常。

配置遗漏判断 #

这属于典型的配置逻辑错误，不是故障：

• Keycloak的默认注册流程依赖“Registration User Profile Creation”步骤生成用户对象，这个步骤是创建用户的核心环节，不能直接禁用——没有它整个注册流程根本无法生成用户实例。
• 即使关闭了Realm的所有邮箱选项，注册流程的后续环节仍可能默认尝试添加必要操作（比如系统残留的Required Action配置），但此时用户对象不存在，双重触发NPE。

修复方案 #

• 不要禁用“Registration User Profile Creation”步骤：如果需要自定义注册字段，应该修改该步骤内的用户配置（比如调整必填字段、隐藏不必要的字段），而非移除整个步骤。
• 若必须替换默认创建逻辑：需要添加自定义的用户创建步骤到注册流程中，确保在任何依赖UserModel的步骤执行前，用户实例已被成功创建。
• 清理残留的Required Action：检查Realm设置中的Required Actions列表，移除所有不需要的强制操作（比如Verify Email），避免流程在用户未创建时触发相关逻辑。

报错信息 #

[org.keycloak.services] (executor-thread-23) KC-SERVICES0013: 
Failed authentication: java.lang.NullPointerException: Cannot 
invoke "org.keycloak.models.UserModel.addRequiredAction(org.keycloak.models.UserModel$RequiredAction)" because "user" is null

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