SpringBootTest报错No qualifying bean：多MessagePublisher Bean冲突问题

问题核心 #

你遇到的错误是因为Spring容器中同时存在两个MessagePublisher类型的Bean：真实实现kafkaMessagePublisher和测试Mock实现mockKafkaMessagePublisher。测试类的@ComponentScan扫描了包含真实Bean的configuration包，导致两个Bean都被实例化，即使给MockBean加了@Primary，注入时仍会因类型匹配不唯一报错。

可行解决方案 #

方案一：排除真实Bean的扫描范围 #

修改测试类，通过@ComponentScan的excludeFilters排除真实MessagePublisher所在的配置类，同时移除重复的@ContextConfiguration（@Import已足够导入测试配置）：

@Slf4j
@ExtendWith(SpringExtension.class)
@SpringBootTest
@Import(KafkaErrorConfig.class)
@ActiveProfiles("mockPublisher")
@ComponentScan(
        basePackages = {"com.aexp.mars.egress.gateway.cucumber.steps"},
        excludeFilters = @ComponentScan.Filter(
                type = FilterType.ASSIGNABLE_TYPE,
                value = RealKafkaMessagePublisherConfig.class // 替换为真实Bean的配置类
        )
)
public class KafkaFailSteps {}

方案二：给真实Bean添加环境限制 #

在真实的kafkaMessagePublisher Bean定义上，添加@Profile注解限制其加载条件，确保仅在非mockPublisher环境下生效：

@Configuration
public class RealKafkaConfig {
    @Bean
    @Profile("!mockPublisher") // 非mock环境才加载真实Bean
    public MessagePublisher kafkaMessagePublisher() {
        // 真实Bean的初始化逻辑
        return new KafkaMessagePublisher(...);
    }
}

调整后的测试类无需额外排除，保留原有扫描范围即可：

@Slf4j
@ExtendWith(SpringExtension.class)
@SpringBootTest
@Import(KafkaErrorConfig.class)
@ActiveProfiles("mockPublisher")
@ComponentScan(basePackages = {
        "com.aexp.mars.egress.gateway.cucumber.steps",
        "com.aexp.mars.egress.gateway.configuration"
})
public class KafkaFailSteps {}

方案三：使用@MockBean快速替换（适用于简单Mock场景） #

如果无需自定义MockBean的复杂逻辑，直接用Spring Boot提供的@MockBean替代自定义测试配置，自动覆盖真实Bean：

@Slf4j
@ExtendWith(SpringExtension.class)
@SpringBootTest
@ActiveProfiles("mockPublisher")
@ComponentScan(basePackages = {
        "com.aexp.mars.egress.gateway.cucumber.steps",
        "com.aexp.mars.egress.gateway.configuration"
})
public class KafkaFailSteps {
    @MockBean
    private MessagePublisher kafkaMessagePublisher;

    // 测试方法中可通过Mockito定义Mock行为
}

额外注意点 #

你的测试配置类中Bean方法名为mockkafkaMessagePublisher，但错误日志中显示的Bean名称是mockKafkaMessagePublisher（大小写不一致），虽然Spring会自动处理Bean名称，但建议保持方法名与预期Bean名称一致，避免混淆。

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