为何ClassPathBeanDefinitionScanner.scan()无法扫描到@Bean注解的Bean?
Spring类路径扫描下@Bean方法定义的Bean未注册问题
场景说明
现有四个自定义Java类,类结构参考下图:
项目基于Spring 5.3.1版本、OpenJDK 11运行,核心代码实现如下:
核心代码
Main.java
public class Main { public static void main(String[] args) { var registry = new SimpleBeanDefinitionRegistry(); var scanner = new ClassPathBeanDefinitionScanner(registry); scanner.setIncludeAnnotationConfig(false); scanner.scan("org.scx.*"); for (var name : registry.getBeanDefinitionNames()) { System.err.println(name); } } }
ClassOne.java
@Component public class ClassOne { }
ClassTwo.java
@Component public class ClassTwo { @Bean public ClassThree classThree() { return new ClassThree(); } }
ClassThree.java
public class ClassThree { }
运行表现
启动Main类后,BeanDefinitionRegistry中仅注册了两个Bean,控制台输出如下:
classOne classTwo
ClassThree对应的Bean没有被注册进容器。
问题根因
- 手动实例化的
ClassPathBeanDefinitionScanner仅承担类路径下的类元数据扫描职责:它会读取类层面的注解,把标注了@Component等构造型注解的类直接生成BeanDefinition并注册到Registry中,整个扫描流程完全不会解析类内部方法上的@Bean注解。 - 代码中调用
scanner.setIncludeAnnotationConfig(false),进一步关闭了扫描阶段对@Configuration注解类的识别支持,不会触发注解配置类的后续解析流程。 - 在ClassTwo中通过@Bean方法定义ClassThree的逻辑,属于注解配置类的解析范畴,这部分能力由Spring内置的
ConfigurationClassPostProcessor(BeanFactory后置处理器)提供。当前代码流程中既没有初始化这个后置处理器,也没有触发其执行,自然无法提取@Bean方法对应的Bean定义,最终导致ClassThree没有被注册。
解决方案参考
要让@Bean方法定义的Bean被正常注册,不能仅依赖裸的类路径扫描器,需要补全注解配置类的解析流程:
- 可以直接使用
AnnotationConfigApplicationContext作为基础容器,该容器内置了类路径扫描、配置类解析、@Bean方法处理的全链路能力,替换手动构建的Registry和裸扫描器即可覆盖常规使用场景 - 如果需要定制化扫描流程,可以手动向BeanFactory中注册
ConfigurationClassPostProcessor,由该后置处理器在容器启动阶段解析所有已注册的配置类,提取方法上的@Bean定义完成注册 - 该需求最终通过实现
SpringApplicationRunListener,在容器启动的对应阶段完成Bean定义的校验与注册,达成了预期效果
内容的提问来源于stack exchange,提问作者scx567888
相关产品推荐
相关产品推荐

