SpringBoot中作为元注解的多个@ComponentScan不被识别问题

问题根因 #

这不是Spring的已知问题，是配置使用方式不符合@ComponentScan规则导致的异常：
你在@ComponentScans中定义了两个扫描路径完全相同的@ComponentScan配置（二者都没有显式指定basePackages，默认都扫描@ContextConfiguration标注类所在的包及其子包），Spring在处理同路径的多套扫描规则时会出现过滤器覆盖的问题，导致只有顺序靠前的那套过滤器生效。

解决方案 #

方案1：合并过滤器到同一个@ComponentScan（最推荐） #

直接把两类匹配规则的过滤器放到同一个@ComponentScan的includeFilters数组中即可，不需要拆分多个@ComponentScan配置，同时建议显式设置useDefaultFilters = false，避免Spring默认的组件扫描规则干扰自定义扫描逻辑：

@Documented
@Target(ElementType.TYPE)
@Retention(RetentionPolicy.RUNTIME)
@Configuration
@ComponentScan(
  useDefaultFilters = false,
  includeFilters = {
    // 扫描CommandHandler实现类
    @ComponentScan.Filter(type = FilterType.ASSIGNABLE_TYPE, classes = CommandHandler.class),
    // 扫描被@CommandService注解的类
    @ComponentScan.Filter(type = FilterType.ANNOTATION, classes = CommandService.class)
  }
)
public @interface ContextConfiguration { }

修改后重启项目即可同时识别CommandHandler实现类和@CommandService标注的类。

方案2：给不同@ComponentScan指定独立扫描路径 #

如果确实需要拆分多套扫描规则，可以给每个@ComponentScan显式指定不同的basePackages，避免同路径下的规则覆盖：

@ComponentScans({
  // 仅扫描handler所在包的CommandHandler实现类
  @ComponentScan(
    basePackages = "org.example.application.handler",
    useDefaultFilters = false,
    includeFilters = @ComponentScan.Filter(type = FilterType.ASSIGNABLE_TYPE, classes = CommandHandler.class)
  ),
  // 仅扫描service所在包的@CommandService类
  @ComponentScan(
    basePackages = "org.example.application.service",
    useDefaultFilters = false,
    includeFilters = @ComponentScan.Filter(type = FilterType.ANNOTATION, classes = CommandService.class)
  )
})

内容的提问来源于stack exchange，提问作者Alexander D.