Spring Boot测试场景下@ConditionalOnBean注解不生效问题排查

• 核心问题是@ConditionalOnBean注解使用方式错误。该注解仅设计用于自动配置类的@Bean方法上，不建议直接标注在@Service等普通扫描组件上：普通组件的扫描注册顺序没有强保证，在生产、测试不同环境下会受类加载顺序、配置加载顺序影响，出现条件判断结果不一致的情况。
• 主启动类@EnableFeignClients明确指定仅注册AnotherFeignClient，因此CommonFeignClient默认不会被注册为Spring Bean。生产环境启动时，Bean注册顺序刚好符合预期：判断CommonService的加载条件时，CommonFeignClient不存在，因此CommonService不会注册；后续判断SimpleHelper的加载条件时，CommonService也不存在，因此SimpleHelper也不会注册，启动无异常。
• 测试环境下手动调用SpringApplication.run启动上下文，没有使用Spring Boot标准测试注解，配置加载、组件扫描的顺序和生产环境存在差异：SimpleHelper做条件判断时，CommonService的Bean定义刚被扫描到但还未执行自身的条件校验，@ConditionalOnBean误判CommonService存在，因此注册了SimpleHelper的Bean定义；等到实际实例化SimpleHelper时，CommonService因为自身依赖的CommonFeignClient不存在，已经被条件过滤掉没有注册，最终抛出找不到CommonService的异常。

• 修正@ConditionalOnBean的使用位置：不要在普通@Service上标注该注解，将条件判断统一移到@Configuration配置类的@Bean方法上，保证条件判断顺序可靠：

// 先移除CommonService和SimpleHelper类上的@Service、@ConditionalOnBean注解
@Configuration
public class AppBeanConfig {
    @Bean
    @ConditionalOnBean(CommonFeignClient.class)
    public CommonService commonService() {
        return new CommonService();
    }

    @Bean
    @ConditionalOnBean(CommonService.class)
    public SimpleHelper simpleHelper(CommonService commonService) {
        return new SimpleHelper(commonService);
    }
}

• 修正Feign客户端注册配置：如果业务中确实需要使用CommonFeignClient，将其加入@EnableFeignClients的客户端列表：

@SpringBootApplication
@EnableFeignClients(clients = {AnotherFeignClient.class, CommonFeignClient.class})
public class Application {
}

如果不需要使用CommonFeignClient，建议直接移除关联的CommonService、SimpleHelper定义，或者改用@ConditionalOnProperty等有明确判断依据的条件注解，避免依赖Bean存在性的隐式判断。

• 修正测试类写法，使用Spring Boot标准测试注解，避免手动启动上下文带来的环境差异：

@SpringBootTest
public class ApplicationTest {
    @Test
    void testContext() {
        // 上下文正常加载即代表测试通过，无需手动调用SpringApplication.run
    }
}

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