SpringBoot 源码解析：AnnotationConfigServletWebServerApplicationContext 构造 | 极客日志

Javajava

SpringBoot 源码解析：AnnotationConfigServletWebServerApplicationContext 构造

SpringBoot 应用上下文初始化过程中，AnnotationConfigServletWebServerApplicationContext 构造方法主要负责两个核心组件的初始化。一是注解 Bean 定义读取器，通过注册 ConfigurationClassPostProcessor 等后置处理器来处理 @Configuration、@Autowired 等注解；二是类路径 Bean 定义扫描器，配置默认过滤器以扫描@Component 等组件注解。这一过程涉及 BeanDefinitionRegistry 接口的使用、Environment 对象的获取以及默认 Bean 工厂的属性设置，为后续 Bean 的加载与依赖注入奠定基础。

奶糖兔发布于 2026/4/7更新于 2026/7/1733 浏览

SpringBoot 源码解析：AnnotationConfigServletWebServerApplicationContext 构造

SpringBoot 源码解析：应用上下文构造流程

在 SpringBoot 启动流程中，创建应用程序上下文是核心环节之一。本文聚焦于 createApplicationContext() 方法的具体实现，深入分析 AnnotationConfigServletWebServerApplicationContext 的初始化过程。

源码入口

在 SpringApplication.run() 方法的执行逻辑中，第 6 步负责创建应用程序上下文：

// SpringApplication 类方法
public ConfigurableApplicationContext run(String... args) {
    // ... 前置步骤 ...
    // 6. 创建应用程序上下文
    context = createApplicationContext();
    // ... 后续步骤 ...
}

核心代码即实例化 AnnotationConfigServletWebServerApplicationContext：

public class AnnotationConfigServletWebServerApplicationContext 
        extends ServletWebServerApplicationContext implements AnnotationConfigRegistry {

    private final AnnotatedBeanDefinitionReader reader;
    private final ClassPathBeanDefinitionScanner scanner;

    public AnnotationConfigServletWebServerApplicationContext() {
        this.reader = new AnnotatedBeanDefinitionReader(this);
        this.scanner = new ClassPathBeanDefinitionScanner(this);
    }
}

这里初始化了两个关键组件：注解 Bean 定义读取器（reader）和类路径 Bean 定义扫描器（scanner）。它们都接收当前上下文实例作为参数，用于后续的 Bean 注册与管理。

一、初始化注解 Bean 定义读取器

AnnotatedBeanDefinitionReader 负责处理带有注解的配置类。其构造函数主要完成三件事：获取注册表、获取环境对象、注册配置处理器。

1. Bean 定义注册接口

相关免费在线工具

Keycode 信息
查找任何按下的键的javascript键代码、代码、位置和修饰符。在线工具，Keycode 信息在线工具，online
Escape 与 Native 编解码
JavaScript 字符串转义/反转义；Java 风格 \uXXXX（Native2Ascii）编码与解码。在线工具，Escape 与 Native 编解码在线工具，online
JavaScript / HTML 格式化
使用 Prettier 在浏览器内格式化 JavaScript 或 HTML 片段。在线工具，JavaScript / HTML 格式化在线工具，online
JavaScript 压缩与混淆
Terser 压缩、变量名混淆，或 javascript-obfuscator 高强度混淆（体积会增大）。在线工具，JavaScript 压缩与混淆在线工具，online
Base64 字符串编码/解码
将字符串编码和解码为其 Base64 格式表示形式即可。在线工具，Base64 字符串编码/解码在线工具，online
Base64 文件转换器
将字符串、文件或图像转换为其 Base64 表示形式。在线工具，Base64 文件转换器在线工具，online

public interface BeanDefinitionRegistry extends AliasRegistry {
    void registerBeanDefinition(String beanName, BeanDefinition beanDefinition);
    void removeBeanDefinition(String beanName);
    BeanDefinition getBeanDefinition(String beanName);
    // ... 其他方法
}

private static Environment getOrCreateEnvironment(BeanDefinitionRegistry registry) {
    if (registry instanceof EnvironmentCapable) {
        return ((EnvironmentCapable) registry).getEnvironment();
    }
    return new StandardEnvironment();
}

public static Set<BeanDefinitionHolder> registerAnnotationConfigProcessors(
        BeanDefinitionRegistry registry, @Nullable Object source) {
    
    DefaultListableBeanFactory beanFactory = unwrapDefaultListableBeanFactory(registry);
    if (beanFactory != null) {
        // 设置依赖比较器，支持 @Order 注解排序
        if (!(beanFactory.getDependencyComparator() instanceof AnnotationAwareOrderComparator)) {
            beanFactory.setDependencyComparator(AnnotationAwareOrderComparator.INSTANCE);
        }
        // 设置自动注入候选解析器
        if (!(beanFactory.getAutowireCandidateResolver() instanceof ContextAnnotationAutowireCandidateResolver)) {
            beanFactory.setAutowireCandidateResolver(new ContextAnnotationAutowireCandidateResolver());
        }
    }

    Set<BeanDefinitionHolder> beanDefs = new LinkedHashSet<>(8);

    // 注册 ConfigurationClassPostProcessor，处理 @Configuration, @Bean 等
    if (!registry.containsBeanDefinition(CONFIGURATION_ANNOTATION_PROCESSOR_BEAN_NAME)) {
        RootBeanDefinition def = new RootBeanDefinition(ConfigurationClassPostProcessor.class);
        def.setSource(source);
        beanDefs.add(registerPostProcessor(registry, def, CONFIGURATION_ANNOTATION_PROCESSOR_BEAN_NAME));
    }

    // 注册 AutowiredAnnotationBeanPostProcessor，处理 @Autowired, @Value
    if (!registry.containsBeanDefinition(AUTOWIRED_ANNOTATION_PROCESSOR_BEAN_NAME)) {
        RootBeanDefinition def = new RootBeanDefinition(AutowiredAnnotationBeanPostProcessor.class);
        def.setSource(source);
        beanDefs.add(registerPostProcessor(registry, def, AUTOWIRED_ANNOTATION_PROCESSOR_BEAN_NAME));
    }

    // 注册 CommonAnnotationBeanPostProcessor，处理 @Resource, @PostConstruct
    if (jsr250Present && !registry.containsBeanDefinition(COMMON_ANNOTATION_PROCESSOR_BEAN_NAME)) {
        RootBeanDefinition def = new RootBeanDefinition(CommonAnnotationBeanPostProcessor.class);
        def.setSource(source);
        beanDefs.add(registerPostProcessor(registry, def, COMMON_ANNOTATION_PROCESSOR_BEAN_NAME));
    }

    // 注册 EventListenerMethodProcessor，处理 @EventListener
    if (!registry.containsBeanDefinition(EVENT_LISTENER_PROCESSOR_BEAN_NAME)) {
        RootBeanDefinition def = new RootBeanDefinition(EventListenerMethodProcessor.class);
        def.setSource(source);
        beanDefs.add(registerPostProcessor(registry, def, EVENT_LISTENER_PROCESSOR_BEAN_NAME));
    }

    return beanDefs;
}

protected void registerDefaultFilters() {
    // 添加 @Component 注解的过滤器
    this.includeFilters.add(new AnnotationTypeFilter(Component.class));
    
    // 尝试加载 JSR-250 和 CDI 相关注解，若存在则支持
    try {
        this.includeFilters.add(new AnnotationTypeFilter(ClassUtils.forName("javax.annotation.ManagedBean", cl), false));
    } catch (ClassNotFoundException ex) { /* 忽略 */ }
    
    try {
        this.includeFilters.add(new AnnotationTypeFilter(ClassUtils.forName("javax.inject.Named", cl), false));
    } catch (ClassNotFoundException ex) { /* 忽略 */ }
}

protected Set<BeanDefinitionHolder> doScan(String... basePackages) {
    Assert.notEmpty(basePackages, "At least one base package must be specified");
    Set<BeanDefinitionHolder> beanDefinitions = new LinkedHashSet<>();

    for (String basePackage : basePackages) {
        Set<BeanDefinition> candidates = findCandidateComponents(basePackage);
        for (BeanDefinition candidate : candidates) {
            ScopeMetadata scopeMetadata = this.scopeMetadataResolver.resolveScopeMetadata(candidate);
            candidate.setScope(scopeMetadata.getScopeName());
            String beanName = this.beanNameGenerator.generateBeanName(candidate, this.registry);

            if (candidate instanceof AbstractBeanDefinition) {
                postProcessBeanDefinition((AbstractBeanDefinition) candidate, beanName);
            }
            if (candidate instanceof AnnotatedBeanDefinition) {
                AnnotationConfigUtils.processCommonDefinitionAnnotations((AnnotatedBeanDefinition) candidate);
            }

            if (checkCandidate(beanName, candidate)) {
                BeanDefinitionHolder definitionHolder = new BeanDefinitionHolder(candidate, beanName);
                definitionHolder = AnnotationConfigUtils.applyScopedProxyMode(scopeMetadata, definitionHolder, this.registry);
                beanDefinitions.add(definitionHolder);
                registerBeanDefinition(definitionHolder, this.registry);
            }
        }
    }
    return beanDefinitions;
}

SpringBoot 源码解析：AnnotationConfigServletWebServerApplicationContext 构造

SpringBoot 源码解析：应用上下文构造流程

源码入口

一、初始化注解 Bean 定义读取器

1. Bean 定义注册接口

更多推荐文章

相关免费在线工具

2. 获取环境对象 Environment

3. 注册注解配置处理器

二、初始化类路径 Bean 定义扫描器

1. 注册默认注解过滤器

2. 自定义包扫描

总结

更多推荐文章

相关免费在线工具

SpringBoot 源码解析：AnnotationConfigServletWebServerApplicationContext 构造

SpringBoot 源码解析：应用上下文构造流程

源码入口

一、初始化注解 Bean 定义读取器

1. Bean 定义注册接口

微信扫一扫，关注极客日志

更多推荐文章

相关免费在线工具

2. 获取环境对象 Environment

3. 注册注解配置处理器

二、初始化类路径 Bean 定义扫描器

1. 注册默认注解过滤器

2. 自定义包扫描

总结

微信扫一扫，关注极客日志

更多推荐文章

相关免费在线工具