使用quarkus-keycloak-admin-client创建Keycloak用户时authHeader为null报错求助

下面是针对这个问题的排查和修复步骤：

• 修正KeycloakBuilder的serverUrl
  你的serverUrl末尾多了斜杠，改为http://localhost:8081（去掉最后的/）。Keycloak Admin Client在拼接API路径时，多余的斜杠会导致请求URL错误，无法正常获取认证令牌，最终引发authHeader为空的问题。

• 确认Keycloak实例的认证信息正确性

  • 确保你连接的Keycloak实例（不管是DevServices启动的还是外部的）中，master域下存在admin用户，且密码确实为admin。
  • 确认admin-cli客户端允许使用password授权类型：在Keycloak控制台的master域 -> 客户端 -> admin-cli -> 配置页，检查“授权类型”是否勾选了“密码”。

• 检查DevServices配置与代码的匹配性
  你的application.properties中配置了%dev.quarkus.keycloak.devservices.enabled=true，这会让Quarkus在dev模式下自动启动内置Keycloak实例：

  • 默认情况下DevServices会保留master域，admin用户密码为admin/admin，这部分和你的代码匹配。但如果你的代码在dev模式下要连接外部Keycloak，需要把%dev.quarkus.keycloak.devservices.enabled设为false，避免端口冲突。
  • 确认quarkus.keycloak.devservices.port=8081确实是DevServices启动的Keycloak端口，没有被其他服务占用。

• 确保依赖正确引入
  检查你的构建文件中是否正确添加了quarkus-keycloak-admin-client依赖：
  Maven示例：

  <dependency>
      <groupId>io.quarkus</groupId>
      <artifactId>quarkus-keycloak-admin-client</artifactId>
  </dependency>
  

  Gradle示例：

  implementation 'io.quarkus:quarkus-keycloak-admin-client'
  

  依赖版本要和你的Quarkus版本保持一致，避免兼容性问题。

• 添加SSL配置（可选）
  如果你的Keycloak实例使用HTTP（比如本地开发），可以在KeycloakBuilder中添加.sslRequired(SslRequired.NONE)，避免因SSL配置问题导致认证失败：

  keycloak = KeycloakBuilder.builder()
          .serverUrl("http://localhost:8081")
          .realm("master")
          .clientId("admin-cli")
          .username("admin")
          .password("admin")
          .grantType(OAuth2Constants.PASSWORD)
          .sslRequired(SslRequired.NONE)
          .build();
  

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