如何阻止Spring的@Configuration类自动运行并按需启用？

核心需求：数据库配置的@Configuration类无需在Spring上下文启动时自动加载，仅在显式调用时才初始化并建立数据库连接。以下是可行的解决方案，同时说明之前尝试方案的局限性：

一、可行实现方案 #

1. 先排除自动扫描，再手动注册配置类 #

步骤1：阻止配置类自动加载

在应用主类或@ComponentScan配置中，通过排除过滤器阻止目标配置类被自动扫描加载：

@SpringBootApplication
@ComponentScan(excludeFilters = {
        @ComponentScan.Filter(
                type = FilterType.ASSIGNABLE_TYPE,
                classes = DatabaseConfig.class
        )
})
public class YourApplication {
    public static void main(String[] args) {
        SpringApplication.run(YourApplication.class, args);
    }
}

步骤2：按需手动注册配置类

当需要初始化数据库连接时，通过Spring的ConfigurableApplicationContext手动注册配置类，触发Bean初始化：

import org.springframework.context.annotation.AnnotatedBeanDefinitionReader;
import org.springframework.context.ConfigurableApplicationContext;
import org.springframework.beans.factory.support.BeanDefinitionRegistry;

// 注入Spring上下文
@Autowired
private ConfigurableApplicationContext context;

public void initDatabaseConnection() {
    // 获取Bean定义注册器
    BeanDefinitionRegistry registry = (BeanDefinitionRegistry) context.getBeanFactory();
    // 注册目标配置类，触发内部@Bean的初始化
    AnnotatedBeanDefinitionReader reader = new AnnotatedBeanDefinitionReader(registry);
    reader.register(DatabaseConfig.class);
}

2. 不使用@Configuration注解，手动创建并注册Bean #

如果不需要配置类的完整特性，也可以将数据库配置逻辑封装为普通类，在需要时手动创建Bean并注册到上下文：

// 普通配置类，不标注@Configuration
public class DatabaseConfig {
    public DataSource createDataSource() {
        HikariDataSource dataSource = new HikariDataSource();
        // 配置数据库连接参数
        dataSource.setJdbcUrl("jdbc:mysql://localhost:3306/db");
        dataSource.setUsername("root");
        dataSource.setPassword("password");
        return dataSource;
    }
}

// 按需初始化时
@Autowired
private ConfigurableApplicationContext context;

public void initDatabase() {
    DatabaseConfig config = new DatabaseConfig();
    DataSource dataSource = config.createDataSource();
    // 将数据源注册为上下文单例Bean
    context.getBeanFactory().registerSingleton("dataSource", dataSource);
}

二、之前方案无效的原因 #

• @ConditionalOnProperty：Spring仅在上下文初始化阶段检查一次属性值，后续修改属性无法触发配置类的重新加载，不支持动态启用。
• @DependsOn和@Order：仅控制Bean的加载顺序，无法阻止配置类被自动扫描和初始化，只要依赖的Bean被创建，目标配置类仍会被加载。
• @ComponentScan排除：确实能阻止自动加载，但需要通过手动注册BeanDefinition的方式恢复启用，而非修改属性或依赖关系。

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