Spring Boot条件加载Bean异常：指定组件未按需加载求助

问题根源 #

1. 错误使用@Configuration注解：ComponentAConfig、ComponentBConfig、ComponentCConfig被标记为@Configuration，但它们本质是配置属性类（用于绑定配置文件中的属性），而非定义Bean的配置类。@Configuration会强制Spring将其作为配置类处理，即使加上@ConditionalOnProperty，也无法阻止Spring为填充MainConfig的属性而实例化这些类。
2. MainConfig无条件限制：MainConfig同时声明了三个不同类型的List属性，Spring Boot的配置绑定机制会自动加载配置文件中所有对应路径的属性，完全忽略use参数的条件。

正确实现方式 #

步骤1：调整配置属性类结构 #

移除组件配置类上的@Configuration注解，仅保留配置属性相关注解：

@Getter
@Setter
@NoArgsConstructor
public abstract class ComponentConfig {
    private String ex1;
    private String ex2;
    private String ex3;
}

@Getter
@Setter
@NoArgsConstructor
public class ComponentAConfig extends ComponentConfig {
}

@Getter
@Setter
@NoArgsConstructor
public class ComponentBConfig extends ComponentConfig {
}

@Getter
@Setter
@NoArgsConstructor
public class ComponentCConfig extends ComponentConfig {
}

步骤2：创建条件化的配置类 #

为每个组件单独创建配置类，通过@ConditionalOnProperty控制是否生效，并绑定对应前缀的配置：

// ComponentA的条件配置类
@Configuration
@ConfigurationProperties(prefix = "application.components.componentA")
@ConditionalOnProperty(prefix = "application", name = "use", havingValue = "componentA")
public class ComponentAConfiguration {
    private List<ComponentAConfig> componentA = new ArrayList<>();

    // 将配置列表暴露为Bean，供业务代码注入
    @Bean
    public List<ComponentAConfig> componentConfigs() {
        return componentA;
    }
}

// ComponentB的条件配置类
@Configuration
@ConfigurationProperties(prefix = "application.components.componentB")
@ConditionalOnProperty(prefix = "application", name = "use", havingValue = "componentB")
public class ComponentBConfiguration {
    private List<ComponentBConfig> componentB = new ArrayList<>();

    @Bean
    public List<ComponentBConfig> componentConfigs() {
        return componentB;
    }
}

// ComponentC的条件配置类
@Configuration
@ConfigurationProperties(prefix = "application.components.componentC")
@ConditionalOnProperty(prefix = "application", name = "use", havingValue = "componentC")
public class ComponentCConfiguration {
    private List<ComponentCConfig> componentC = new ArrayList<>();

    @Bean
    public List<ComponentCConfig> componentConfigs() {
        return componentC;
    }
}

步骤3：业务代码中注入配置列表 #

在需要使用配置的地方，直接注入List<? extends ComponentConfig>，Spring会自动根据application.use的值注入对应的配置列表：

@Service
public class ComponentService {
    private final List<? extends ComponentConfig> componentConfigs;

    // 构造方法注入
    public ComponentService(List<? extends ComponentConfig> componentConfigs) {
        this.componentConfigs = componentConfigs;
    }

    // 业务逻辑
    public void handleComponents() {
        componentConfigs.forEach(config -> {
            // 处理每个配置项
        });
    }
}

替代方案：统一配置类+条件属性绑定 #

如果希望保留MainConfig的结构，可以通过自定义条件逻辑动态绑定配置：

@Configuration
@ConfigurationProperties(prefix = "application.components")
@Getter
@Setter
@NoArgsConstructor
public class MainConfig {
    private List<ComponentConfig> currentComponents;

    @PostConstruct
    public void init() {
        Environment environment = SpringContextHolder.getEnvironment();
        String useComponent = environment.getProperty("application.use");
        
        // 使用Spring Boot的Binder API手动绑定对应配置
        Binder binder = Binder.get(environment);
        if ("componentA".equals(useComponent)) {
            currentComponents = binder.bind("componentA", Bindable.listOf(ComponentAConfig.class)).orElse(new ArrayList<>());
        } else if ("componentB".equals(useComponent)) {
            currentComponents = binder.bind("componentB", Bindable.listOf(ComponentBConfig.class)).orElse(new ArrayList<>());
        } else if ("componentC".equals(useComponent)) {
            currentComponents = binder.bind("componentC", Bindable.listOf(ComponentCConfig.class)).orElse(new ArrayList<>());
        }
    }
}

注：SpringContextHolder需自行实现，用于获取Spring环境上下文。

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