使用Keycloak Admin Client始终返回401未授权异常的求助

核心问题：Server URL配置错误 #

Keycloak 17+版本移除了旧的/auth路径，但**KeycloakBuilder的serverUrl仅需填写Keycloak的根地址**，不需要附加/admin。你当前配置的http://localhost:8080/admin会导致admin client自动拼接出错误的认证端点（http://localhost:8080/admin/admin/realms/master/protocol/openid-connect/token），直接引发认证失败，最终导致authToken为null。

修复步骤 #

1. 修正Server URL
   将代码中的serverUrl改为Keycloak根地址：

   Keycloak keycloak = KeycloakBuilder.builder()
           .serverUrl("http://localhost:8080") // 移除末尾的/admin
           .realm("master")
           .clientId("admin-cli")
           .grantType(OAuth2Constants.PASSWORD)
           .username("admin")
           .password("admin")
           .resteasyClient(new ResteasyClientBuilderImpl().connectionPoolSize(10).build())
           .build();
   

2. 补充必要依赖（若缺失）
   除keycloak-admin-client外，还需添加Resteasy的JSON序列化依赖，否则可能出现隐式请求处理异常。在pom.xml中追加：

   <dependency>
       <groupId>org.jboss.resteasy</groupId>
       <artifactId>resteasy-jackson2-provider</artifactId>
       <version>6.2.7.Final</version> <!-- 版本需与Keycloak 23兼容 -->
   </dependency>
   

3. 验证认证流程
   修复后，admin client会正确请求认证端点http://localhost:8080/admin/realms/master/protocol/openid-connect/token，成功获取authToken后即可正常调用Realm和Client的创建接口。

额外检查点 #

• 确保Java应用能访问Keycloak容器：若Java应用未在Docker容器内运行，确认localhost:8080可正常访问Keycloak管理控制台（你已能登录，此步骤大概率无问题）。
• 确认admin-cli客户端存在：master realm默认自带该客户端，无需额外创建。

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