类上使用@ConditionalOnMissingBean注解不生效问题咨询

核心问题 #

你遇到的@ConditionalOnMissingBean不生效，主要有两个关键原因：

1. 类级别条件注解的执行时机偏差：直接在@RestController类上标注@ConditionalOnMissingBean时，Spring组件扫描阶段的条件判断逻辑，无法精准感知容器中是否已存在同名Bean（尤其当存在其他自动扫描的同名Bean时）。
2. 控制器方法访问权限错误：b()方法用private修饰，Spring MVC无法识别并映射该请求方法，即便Bean注册成功，接口也无法正常响应。

修复步骤 #

1. 改用配置类+@Bean的方式注册控制器 #

将控制器的注册逻辑转移到配置类中，通过@Bean方法配合@ConditionalOnMissingBean，能精准控制Bean的注册时机：

@Configuration
public class TestControllerConfig {

    @Bean("testController")
    @ConditionalOnMissingBean(name = "testController")
    public TestController testController() {
        return new TestController();
    }
}

2. 修正控制器方法的访问修饰符 #

把b()方法的修饰符改为public，确保Spring MVC能正确识别并处理请求：

@RestController
@RequestMapping("/a")
public class TestController {

    @GetMapping("/b")
    public String b() {
        return "1";
    }
}

3. 避免原控制器被自动扫描 #

如果TestController所在包被@ComponentScan或@SpringBootApplication的默认扫描覆盖，需排除该类，防止自动注册导致逻辑冲突：

在启动类中添加排除配置：

@SpringBootApplication(exclude = TestController.class)
public class YourApplication {
    public static void main(String[] args) {
        SpringApplication.run(YourApplication.class, args);
    }
}

或者将TestController放到@ComponentScan未覆盖的包路径下。

额外说明 #

• @ConditionalOnMissingBean在@Bean方法上使用时，会在该Bean注册前检查容器中是否存在指定名称/类型的Bean，逻辑可靠性更高。
• 基于Spring Boot的项目，需确保配置类处于启动类所在包或其子包下，保证能被Spring扫描到。

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