如何通过keycloak.enabled配置禁用Spring Boot集成的Keycloak？

问题原因 #

官方Keycloak适配器的keycloak.enabled配置仅能控制Keycloak自动配置的部分属性，你自定义的@KeycloakConfiguration配置类默认不受该配置控制，所以即使设为false，配置类依然会加载并初始化Keycloak安全过滤器链，导致配置不生效。
另外你现有依赖存在版本错误：

• keycloak-spring-boot-starter版本需要和bom的15.0.2保持一致，你当前写的2.5.5是Spring Boot版本号，不是Keycloak适配器版本
• spring-boot-starter-security不存在15.0.2版本，需改为和你Spring Boot主版本匹配的版本，和Keycloak 15适配的Spring Boot版本为2.5.x/2.6.x系列

解决方案 #

步骤1：给Keycloak配置类加条件注解 #

在你现有的PKeycloakConfig类上新增@ConditionalOnProperty注解，只有keycloak.enabled为true时才加载该配置类：

@KeycloakConfiguration
@ConditionalOnProperty(name = "keycloak.enabled", havingValue = "true", matchIfMissing = true)
public class PKeycloakConfig extends KeycloakWebSecurityConfigurerAdapter {
    // 原有代码保持不变
}

matchIfMissing = true表示如果没有配置keycloak.enabled，默认开启Keycloak功能。

步骤2：新增禁用Keycloak时的兜底安全配置 #

新建一个配置类，当keycloak.enabled设为false时加载，绕过Keycloak验证（可根据自身需求调整权限规则）：

@Configuration
@ConditionalOnProperty(name = "keycloak.enabled", havingValue = "false")
public class DisableKeycloakConfig extends WebSecurityConfigurerAdapter {
    @Override
    protected void configure(HttpSecurity http) throws Exception {
        http.authorizeRequests()
            .anyRequest().permitAll()
            .and().csrf().disable();
    }
}

步骤3：配置文件添加开关 #

在application.properties中添加对应配置：

# 设为false即可禁用Keycloak
keycloak.enabled = false

额外排查点 #

如果以上配置仍不生效，检查以下项：

• 不要在启动类上手动排除Keycloak相关的自动配置类，避免条件注解失效
• 确认所有Keycloak相关依赖版本统一，避免版本冲突导致配置不加载
• 如果使用Spring Boot 2.4+，检查配置文件的多环境激活规则，确认开关配置被正确加载

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