Spring测试中接口标注@ComponentScan无法加载实现类Bean的问题

核心根因 #

Spring 的配置注解处理器仅会识别标注在类上的@ComponentScan注解，标注在接口上的@ComponentScan会被直接忽略。
你在OpenElevationClient接口上标注的@ComponentScan不会生效，测试上下文指定classes = OpenElevationClient.class时，不会触发对应包的组件扫描，自然找不到@Service标注的OpenElevationClientImpl Bean；而OpenElevationConfig是普通类，标注的@ComponentScan会被正常解析，触发同包路径的扫描，就能加载到实现类Bean。

为什么主应用不受影响 #

主应用启动类通常带有@SpringBootApplication注解，其中内置的@ComponentScan会默认扫描启动类所在包及其子包下的所有组件，此时不管OpenElevationClient接口上的@ComponentScan是否生效，实现类已经被启动类的扫描逻辑加载，所以运行正常。而测试场景下你通过@SpringBootTest(classes = ...)指定了上下文配置类，不会走主启动类的默认扫描逻辑，完全依赖你指定的配置类的注解，所以会出现测试和主应用运行结果不一致的情况。

实践建议 #

• 不要将@ComponentScan、@Configuration这类Spring配置注解标注在接口上，这类注解仅对类生效
• 若需要自定义扫描配置，单独创建普通配置类（比如你用到的OpenElevationConfig）承载配置注解即可
• 也可以直接在测试类上添加@ComponentScan("对应包路径")手动指定扫描范围，不需要额外创建标记类

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