You need to enable JavaScript to run this app. 为何ClassPathBeanDefinitionScanner.scan()无法扫描到@Bean注解的Bean?
优惠活动
大模型
产品
解决方案
定价
更多

为何ClassPathBeanDefinitionScanner.scan()无法扫描到@Bean注解的Bean?

Spring类路径扫描下@Bean方法定义的Bean未注册问题

场景说明

现有四个自定义Java类,类结构参考下图:
enter image description here
项目基于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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.17 12:45:04