已添加@ConditionalOnMissingBean仍无法覆盖Spring Bean的问题

库项目中定义的类：

@ConditionalOnMissingBean(name = "myServiceActivator")
@Component(value = "myServiceActivator")
public class MyServiceActivator {

    @ServiceActivator(inputChannel = "SomeChannel")
    public void handleApplicationEvent(@Payload Object object) {
        // ...
    }

}

依赖该库的项目中定义的类：

@Component(value = "myServiceActivator")
public class ChildServiceActivator {

    @ServiceActivator(inputChannel = "SomeChannel")
    public void handleApplicationEvent(@Header("SomeHeader") String header, @Payload Object object) {
        // Do something else
    }
}

启动时抛出异常：

Caused by: org.springframework.context.annotation.ConflictingBeanDefinitionException: Annotation-specified bean name 'myServiceActivator' for bean class [com.company.project.domain.integration.ChildServiceActivator] conflicts with existing, non-compatible bean definition of same name and class [com.company.commons.domain.integration.MyServiceActivator]

原本预期@ConditionalOnMissingBean会跳过MyServiceActivator的创建，但实际未生效，请问原因是什么？如何只创建ChildServiceActivator实例？

@ConditionalOnMissingBean的生效时机是Spring处理Bean实例化的阶段，但@Component标注的Bean是被组件扫描机制提前发现并注册Bean定义的。这里的核心问题是：

• 库中的MyServiceActivator和项目中的ChildServiceActivator都带@Component注解，组件扫描时会同时把两个同名的Bean定义加载到容器里，此时还没到@ConditionalOnMissingBean的条件判断环节，直接触发了同名Bean定义的冲突。
• 简单说，@ConditionalOnMissingBean管的是Bean要不要实例化，但组件扫描已经把两个冲突的Bean定义先注册了，根本轮不到条件判断生效。

有两种可靠的解决方式：

方式一：修改库中Bean的定义逻辑 #

把库中的MyServiceActivator改成通过配置类的@Bean方法定义，这样@ConditionalOnMissingBean会在Bean定义阶段就生效，避免冲突：

// 新增配置类
@Configuration
public class MyServiceConfig {

    @ConditionalOnMissingBean(name = "myServiceActivator")
    @Bean(name = "myServiceActivator")
    public MyServiceActivator myServiceActivator() {
        return new MyServiceActivator();
    }
}

// 原MyServiceActivator去掉@Component注解
public class MyServiceActivator {

    @ServiceActivator(inputChannel = "SomeChannel")
    public void handleApplicationEvent(@Payload Object object) {
        // ...
    }
}

这样Spring会先检查容器中是否存在名为myServiceActivator的Bean，发现项目中已经有ChildServiceActivator后，就不会再注册库中的Bean定义，自然不会冲突。

方式二：在项目中排除库中的Bean #

如果没法修改库的代码，可以在项目的组件扫描中排除库中的MyServiceActivator：

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

或者直接用Spring Boot的exclude属性简化配置：

@SpringBootApplication(exclude = MyServiceActivator.class)
public class YourApplication {
    // ...
}

这样组件扫描时会跳过库中的MyServiceActivator，只注册项目里的ChildServiceActivator。

内容的提问来源于stack exchange，提问作者Hasan Can Saral