Spring Boot条件Bean单元测试：如何仅测试已创建Bean？

碰到这种用@ConditionalOnProperty控制Bean创建，但单元测试因Bean缺失报错的情况，完全不用拆分子库，试试下面这几个实用方案：

1. 在测试类中激活对应配置属性 #

既然Bean的创建依赖配置文件的属性，那在测试时直接在测试类上指定需要的属性值，让Spring上下文创建对应的Bean就行。

你可以用@SpringBootTest的properties参数，或者@TestPropertySource注解来临时覆盖配置：

// 激活mysql后端的配置，让MysqlBackendService被创建
@SpringBootTest(properties = {"feature.backend=mysql"})
public class MysqlBackendServiceTest {
    @Autowired
    private BackendService backendService;

    @Test
    void testFetchData() {
        String data = backendService.fetchData();
        // 断言逻辑...
    }
}

这种方式适合集成测试，能真实模拟对应配置下的Bean环境。

2. 用@MockBean替代缺失的依赖Bean #

如果你的测试只关注某个服务的逻辑，不需要真实的Conditional Bean，那直接用@MockBean来模拟这个缺失的依赖，就能避免UnsatisfiedDependencyException。

比如你的SomeService依赖BackendService，但BackendService没被创建，就可以这样写：

@SpringBootTest
public class SomeServiceTest {
    @Autowired
    private SomeService someService;

    // 模拟缺失的BackendService
    @MockBean
    private BackendService backendService;

    @Test
    void testBusinessLogic() {
        // 预设mock的返回值
        when(backendService.fetchData()).thenReturn("mock test data");
        
        String result = someService.processData();
        assertEquals("processed mock data", result);
    }
}

这种方式适合单元测试，专注于测试目标类的逻辑，不用关心依赖Bean的真实实现。

3. 按配置分组测试类 #

把不同配置对应的测试拆分成独立的测试类，每个测试类只激活对应配置，这样每个测试类的上下文里都会有对应的Bean，不会出现依赖缺失。

比如：

// 专门测试MySQL后端的集成测试
@SpringBootTest(properties = {"feature.backend=mysql"})
public class MysqlBackendIntegrationTest {
    @Autowired
    private MysqlBackendService mysqlBackendService;

    @Test
    void testMysqlSpecificLogic() {
        // 测试MySQL特有的逻辑...
    }
}

// 专门测试Redis后端的集成测试
@SpringBootTest(properties = {"feature.backend=redis"})
public class RedisBackendIntegrationTest {
    @Autowired
    private RedisBackendService redisBackendService;

    @Test
    void testRedisSpecificLogic() {
        // 测试Redis特有的逻辑...
    }
}

这种方式逻辑清晰，每个测试类只负责对应配置下的测试场景，维护起来也方便。

4. 用@TestConfiguration手动注册需要的Bean #

如果需要更灵活的控制，比如在测试时手动指定要创建的Bean，可以在测试类里加一个静态的@TestConfiguration类，手动注册需要的Bean：

@SpringBootTest
public class BackendServiceTest {
    @Autowired
    private BackendService backendService;

    // 测试时手动注册MysqlBackendService
    @TestConfiguration
    static class TestBackendConfig {
        @Bean
        public BackendService backendService() {
            return new MysqlBackendService();
        }
    }

    @Test
    void testCommonBackendLogic() {
        // 测试BackendService的通用逻辑...
    }
}

这种方式适合需要自定义测试Bean的场景，比如要给Bean设置测试专用的参数。

为什么测试方法上加@ConditionalOnProperty没用？ #

顺便说下你之前踩的坑：@ConditionalOnProperty是用来控制Spring上下文里Bean的注册逻辑的，它只能用在@Configuration类、@Bean方法或者组件类上，测试方法上的这个注解根本不会被Spring处理，所以自然无效啦。

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