Spring Boot注入Keycloak实例失败，如何配置对应Bean？

你遇到的问题是因为Spring Boot不会自动为Keycloak Admin Client创建Bean，需要手动在配置类中定义。以下是具体步骤：

1. 确认依赖（若未添加） #

确保你的项目中引入了Keycloak Admin Client依赖，Maven示例：

<dependency>
    <groupId>org.keycloak</groupId>
    <artifactId>keycloak-admin-client</artifactId>
    <!-- 版本需与你的Keycloak服务器版本一致 -->
    <version>18.0.0</version>
</dependency>

2. 创建Keycloak配置类 #

新建一个配置类，读取yaml中的配置并构建Keycloak实例，注册为Spring Bean：

import org.keycloak.admin.client.Keycloak;
import org.keycloak.admin.client.KeycloakBuilder;
import org.springframework.beans.factory.annotation.Value;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

@Configuration
public class KeycloakAdminConfig {

    @Value("${keycloak.auth-server-url}")
    private String authServerUrl;

    @Value("${keycloak.realm}")
    private String realm;

    @Value("${keycloak.resource}")
    private String clientId;

    @Value("${keycloak.credentials.secret}")
    private String clientSecret;

    // 需配置拥有Realm管理权限的用户账号
    @Value("${keycloak.admin.username}")
    private String adminUsername;

    @Value("${keycloak.admin.password}")
    private String adminPassword;

    @Bean
    public Keycloak keycloak() {
        return KeycloakBuilder.builder()
                .serverUrl(authServerUrl)
                .realm(realm)
                .clientId(clientId)
                .clientSecret(clientSecret)
                .username(adminUsername)
                .password(adminPassword)
                .build();
    }
}

3. 补充yaml配置 #

在你的配置文件中添加管理员账号密码（该用户需在Keycloak后台拥有manage-users等Realm管理权限）：

keycloak.auth-server-url: http://localhost:8081/auth
keycloak.realm: myRealm
keycloak.resource: myClient
keycloak.credentials.secret: mySecret
# 新增管理员配置
keycloak.admin.username: admin
keycloak.admin.password: your-admin-password

说明 #

你之前的yaml配置是用于Spring Boot Keycloak Starter（资源服务器认证场景），而Keycloak Admin Client是独立的管理API客户端，需要手动构建实例并注册为Bean。配置完成后，你的UsersKCLKServiceImpl中@Autowired private Keycloak keycloak;就能正常注入并使用了。

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