Keycloak从16.1.1升级至17.0.0后登录页出现NullPointerException如何解决？

异常详情 #

ERROR [org.keycloak.services.error.KeycloakErrorHandler] (executor-thread-0) Uncaught server error: java.lang.NullPointerException
at org.keycloak.protocol.AuthorizationEndpointBase.handleBrowserAuthenticationRequest(AuthorizationEndpointBase.java:107)
at org.keycloak.protocol.oidc.endpoints.AuthorizationEndpoint.buildAuthorizationCodeAuthorizationResponse(AuthorizationEndpoint.java:326)
at org.keycloak.protocol.oidc.endpoints.AuthorizationEndpoint.process(AuthorizationEndpoint.java:189)
at org.keycloak.protocol.oidc.endpoints.AuthorizationEndpoint.buildGet(AuthorizationEndpoint.java:112)
at java.base/jdk.internal.reflect.NativeMethodAccessorImpl.invoke0(Native Method)
at java.base/jdk.internal.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:62)
at java.base/jdk.internal.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:43)
at java.base/java.lang.reflect.Method.invoke(Method.java:566)

解决方法 #

• 检查客户端重定向URI配置
  Keycloak 17对客户端Valid Redirect URIs的校验逻辑更严格，空值或不规范配置会触发空指针。进入Keycloak控制台，找到对应Realm下的目标客户端，在Settings标签页中确保Valid Redirect URIs填写了正确的非空值（例如https://your-application-domain/*），避免留空或错误配置。

• 清理旧会话与缓存
  升级后残留的旧会话数据可能与新版本不兼容，导致认证流程中出现空对象引用：

  1. 进入对应Realm的Sessions标签页，清除所有用户会话；
  2. 进入目标客户端的Sessions页面，清除该客户端的所有会话；
  3. 重启Keycloak服务，彻底清除服务器端缓存。

• 排查自定义主题或扩展
  自定义登录主题或第三方扩展可能因Keycloak 17的API变更导致空指针。先切换回默认的keycloak主题测试，若异常消失，需适配自定义主题至新版本API；对于自定义扩展，检查AuthorizationEndpointBase相关调用逻辑，修复空值引用问题。

• 重置Realm认证流程
  升级后Realm的认证流程配置可能异常，进入对应Realm的Authentication → Flows页面，将Browser流程重置为默认配置，再测试登录功能。

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