Keycloak 20.0.2配置：@KeycloakConfiguration需额外实现方法的疑问

问题原因 #

你遇到的提示源于KeycloakWebSecurityConfigurerAdapter实现了SecurityConfigurer接口，在部分依赖组合或环境下，编译器/IDE无法识别父类已有的默认实现，强制要求显式重写这两个方法。同时你的依赖配置存在重复引入问题，可能加剧了版本冲突导致的接口实现识别异常。

解决方案 #

1. 清理重复依赖 #

你的pom.xml中同时引入了keycloak-spring-boot-starter和keycloak-spring-security-adapter，前者已包含后者，重复引入会引发版本冲突。请删除单独的keycloak-spring-security-adapter依赖，保留keycloak-spring-boot-starter即可，dependencyManagement中的BOM会自动管理所有Keycloak相关依赖版本：

<dependencies>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-data-jpa</artifactId>
    </dependency>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-web</artifactId>
    </dependency>
    <dependency>
        <groupId>org.postgresql</groupId>
        <artifactId>postgresql</artifactId>
        <scope>runtime</scope>
    </dependency>
    <dependency>
        <groupId>org.keycloak</groupId>
        <artifactId>keycloak-spring-boot-starter</artifactId>
    </dependency>
    <!-- 删除以下重复依赖 -->
    <!--
    <dependency>
        <groupId>org.keycloak</groupId>
        <artifactId>keycloak-spring-security-adapter</artifactId>
        <version>20.0.2</version>
    </dependency>
    -->
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-security</artifactId>
    </dependency>
</dependencies>

<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>org.keycloak.bom</groupId>
            <artifactId>keycloak-adapter-bom</artifactId>
            <version>20.0.2</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency>
    </dependencies>
</dependencyManagement>

2. 显式重写并调用父类方法 #

若清理依赖后仍提示需实现init和configure方法，直接重写这两个方法并调用父类实现即可——KeycloakWebSecurityConfigurerAdapter已提供完整逻辑，显式重写仅为满足编译器检查：

@KeycloakConfiguration
public class SecurityConfig extends KeycloakWebSecurityConfigurerAdapter
{
    /**
     * Registers the KeycloakAuthenticationProvider with the authentication manager.
     */
    @Autowired
    public void configureGlobal(AuthenticationManagerBuilder auth) throws Exception {
        auth.authenticationProvider(keycloakAuthenticationProvider());
    }

    /**
     * Defines the session authentication strategy.
     */
    @Bean
    @Override
    protected SessionAuthenticationStrategy sessionAuthenticationStrategy() {
        return new RegisterSessionAuthenticationStrategy(buildSessionRegistry());
    }

    @Bean
    protected SessionRegistry buildSessionRegistry() {
        return new SessionRegistryImpl();
    }

    @Override
    protected void configure(HttpSecurity http) throws Exception
    {
        super.configure(http);
        http
                .authorizeRequests()
                .antMatchers("/customers*").hasRole("USER")
                .antMatchers("/admin*").hasRole("ADMIN")
                .anyRequest().permitAll();
    }

    // 新增重写init方法，调用父类实现
    @Override
    public void init(WebSecurity web) throws Exception {
        super.init(web);
    }

    // 新增重写configure方法，调用父类实现
    @Override
    public void configure(WebSecurity web) throws Exception {
        super.configure(web);
    }
}

补充说明 #

• 这两个方法是SecurityConfigurer接口的标准方法，父类已实现核心逻辑，显式重写不会改变原有功能。
• 确保Spring Boot版本与Keycloak 20.0.2兼容，推荐使用Spring Boot 2.7.x系列。

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