Spring应用@ActiveProfile不生效 多DataSource引发No qualifying bean异常

根因 #

原生Spring框架的@Profile注解规则为：未标注@Profile的Bean属于所有激活的Profile，无论当前激活什么Profile，这类Bean都会被注册到容器中。
你当前的生产环境DataSource未绑定任何Profile，因此激活test Profile时，无Profile限制的生产数据源、标注了@Profile("test")的测试数据源会同时被注册，容器中存在两个同类型的DataSource Bean，依赖注入时无法匹配到唯一实例，因此抛出No qualifying bean异常。

解决方案 #

1. 给生产数据源绑定非test的Profile（推荐） #

给生产环境的DataSource的@Bean方法添加@Profile("!test")或者@Profile("default")注解，这样激活test Profile时，生产数据源不会被注册，容器中只会存在测试数据源：

@Configuration
public class SpringConfig {
    // 生产数据源：仅test profile未激活时注册
    @Bean
    @Profile("!test")
    public DataSource prodDataSource() {
        // 生产数据源配置逻辑
    }

    // 测试数据源：仅test profile激活时注册
    @Bean
    @Profile("test")
    public DataSource testDataSource() {
        // 测试数据源配置逻辑
    }
}

2. 修正配置类中DataSource的依赖注入方式 #

检查JPA实体管理器工厂、事务管理器等依赖DataSource的组件配置，不要直接调用生产DataSource的@Bean方法，改为通过方法参数注入DataSource，让Spring自动匹配容器中可用的实例：

// 错误写法：直接调用prodDataSource()方法，会绕过Profile规则直接实例化生产数据源
@Bean
public LocalContainerEntityManagerFactoryBean entityManagerFactory() {
    LocalContainerEntityManagerFactoryBean em = new LocalContainerEntityManagerFactoryBean();
    em.setDataSource(prodDataSource());
    // 其他配置
    return em;
}

// 正确写法：通过方法参数注入容器中的可用DataSource
@Bean
public LocalContainerEntityManagerFactoryBean entityManagerFactory(DataSource dataSource) {
    LocalContainerEntityManagerFactoryBean em = new LocalContainerEntityManagerFactoryBean();
    em.setDataSource(dataSource);
    // 其他配置
    return em;
}

3. 其他排查点 #

• 确认@Profile("test")标注在测试DataSource的@Bean方法上，无大小写、拼写错误
• 确认测试类导入的@ActiveProfiles是org.springframework.test.context.ActiveProfiles，注解属性值为"test"无拼写错误
• 若特殊场景下需要保留两个DataSource同时注册，可给测试DataSource添加@Primary注解，设置为优先注入的Bean

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