spring 的 核心 refresh() 方法阅读技巧

Spring 的refresh()方法是理解整个 IoC 容器核心逻辑的最佳入口。这个方法就像容器的“启动总纲”定义了从加载配置到创建所有单例 Bean 的完整流程。下面我帮你把它拆解成几个易于理解的阶段并告诉你每一步该看什么、怎么调试。 一、先找到refresh()方法所在类org.springframework.context.support.AbstractApplicationContext版本以你正在阅读的 5.3.x 为例定位技巧在 IDEA 中双击Shift输入AbstractApplicationContext.refresh直接跳转这个方法是public void refresh() throws BeansException, IllegalStateException它的代码结构非常清晰由一系列具有明确职责的子方法组成。 二、宏观俯瞰refresh() 的整体骨架先看一眼方法的整体结构大概有十几个步骤但核心可以归纳为三大阶段准备阶段为容器启动做准备环境、监听器等BeanFactory 创建与配置阶段加载配置、注册 BeanPostProcessor、执行 BeanFactoryPostProcessor单例 Bean 实例化阶段初始化所有剩余的单例 Bean非懒加载对应的代码骨架简化后public void refresh() throws BeansException, IllegalStateException { synchronized (this.startupShutdownMonitor) { // 1. 准备上下文 prepareRefresh(); // 2. 获取新的 BeanFactory通常是从新加载的配置中创建 ConfigurableListableBeanFactory beanFactory obtainFreshBeanFactory(); // 3. 对 BeanFactory 进行预填充如设置类加载器、添加后置处理器等 prepareBeanFactory(beanFactory); try { // 4. 允许子类对 BeanFactory 进行后置处理模板方法 postProcessBeanFactory(beanFactory); // 5. 调用 BeanFactoryPostProcessor重要 invokeBeanFactoryPostProcessors(beanFactory); // 6. 注册 BeanPostProcessor重要 registerBeanPostProcessors(beanFactory); // 7. 初始化消息源国际化 initMessageSource(); // 8. 初始化事件广播器 initApplicationEventMulticaster(); // 9. 模板方法留给子类刷新特定 bean onRefresh(); // 10. 注册监听器 registerListeners(); // 11. **核心实例化所有非懒加载的单例 Bean** finishBeanFactoryInitialization(beanFactory); // 12. 最后一步发布容器刷新完成事件 finishRefresh(); } catch (BeansException ex) { // 异常处理销毁已创建的 bean destroyBeans(); cancelRefresh(ex); throw ex; } finally { // 重置公共缓存 resetCommonCaches(); } } } 三、关键步骤拆解建议打断点阅读你可以从第 1 步开始逐行 Debug 或者直接跳到最核心的finishBeanFactoryInitialization。但为了更好地理解上下文建议按顺序跟踪。1️⃣prepareRefresh()做什么设置启动时间、激活状态、初始化属性源、验证必要属性。关注点initPropertySources()是一个模板方法留给子类扩展例如 Web 环境会设置 servlet 相关属性。断点可以放在方法内部观察environment的变化。2️⃣obtainFreshBeanFactory()做什么这是创建或刷新 BeanFactory 的地方。调用链refreshBeanFactory()→ 如果是AbstractRefreshableApplicationContext如 XML 或注解配置会销毁原有的 BeanFactory重新加载配置创建新的DefaultListableBeanFactory并读取所有 Bean 定义loadBeanDefinitions。关注点从这里开始容器拥有了所有 Bean 的元信息BeanDefinition。断点在loadBeanDefinitions方法中可以观察 XML 或注解是如何被解析成BeanDefinition的。3️⃣prepareBeanFactory(beanFactory)做什么为 BeanFactory 配置标准特性如设置类加载器添加ApplicationContextAwareProcessor处理 Aware 接口注册一些特殊的单例 Bean如environment、systemProperties等关注点这里注册的BeanPostProcessor会在后续对所有 Bean 生效。4️⃣postProcessBeanFactory(beanFactory)做什么空方法留给子类覆盖例如在 Web 环境中注册 Web 相关的 Scope 或 ServletContextAwareProcessor。断点如果你在 Web 环境下调试可以关注子类的实现。5️⃣invokeBeanFactoryPostProcessors(beanFactory)⭐️做什么调用所有注册的BeanFactoryPostProcessor包括BeanDefinitionRegistryPostProcessor。谁在这里执行例如ConfigurationClassPostProcessor处理Configuration类、PropertySourcesPlaceholderConfigurer解析占位符${...}。效果此时可以对尚未实例化的BeanDefinition进行修改或注册新 Bean。断点观察BeanFactoryPostProcessor的执行顺序以及BeanDefinition的变化。6️⃣registerBeanPostProcessors(beanFactory)⭐️做什么将所有实现了BeanPostProcessor接口的 Bean 注册到 BeanFactory 的beanPostProcessors列表中。注意这里只是注册不会调用它们的方法。顺序先注册实现了PriorityOrdered的再是Ordered最后是普通的。断点可以查看beanPostProcessors列表的内容。7️⃣initMessageSource()做什么初始化国际化消息源。关注点如果容器中没有名为messageSource的 Bean会注册一个DelegatingMessageSource作为空实现。8️⃣initApplicationEventMulticaster()做什么初始化事件广播器。默认是SimpleApplicationEventMulticaster。关注点这里决定了事件发布的方式同步/异步。9️⃣onRefresh()做什么模板方法留给子类初始化特定的 Bean例如 Web 容器中的ThemeSource或内嵌 Web 服务器。断点如果你在 Spring Boot 中调试这里会触发ServletWebServerApplicationContext的onRefresh()从而启动内嵌 Tomcat。registerListeners()做什么将容器中所有实现了ApplicationListener的 Bean 注册到事件广播器并可能发布早期事件。关注点可以观察监听器是如何被添加的。1️⃣1️⃣finishBeanFactoryInitialization(beanFactory)⭐️⭐️⭐️做什么核心中的核心——实例化所有剩余的非懒加载单例 Bean。如何实现调用beanFactory.preInstantiateSingletons()该方法会遍历所有BeanDefinition依次调用getBean()最终触发doCreateBean。关键子步骤处理 FactoryBean加前缀获取 FactoryBean 本身解决循环依赖三级缓存登场调用 BeanPostProcessor 的postProcessBeforeInitialization和postProcessAfterInitialization执行InitializingBean.afterPropertiesSet()和自定义 init-method断点这是最重要的断点位置。可以从getBean开始一路跟踪到doCreateBean观察 Bean 的完整生命周期。1️⃣2️⃣finishRefresh()做什么清理资源缓存、初始化生命周期处理器、发布ContextRefreshedEvent事件。关注点这里触发了实现了SmartLifecycle的 Bean 的启动。 四、推荐调试路线起点在你的测试类中调用new AnnotationConfigApplicationContext(MyConfig.class)后立即在refresh()方法第一行打上断点。逐步前进用 F8Step Over逐个步骤执行观察每个方法调用前后的变化。深入核心当执行到finishBeanFactoryInitialization时用 F7Step Into进入该方法再进入preInstantiateSingletons()然后观察getBean的调用。观察循环依赖如果你的测试中有循环依赖的场景可以重点关注三级缓存singletonObjects、earlySingletonObjects、singletonFactories的变化。观察后置处理器在doCreateBean中留意applyBeanPostProcessorsBeforeInitialization和applyBeanPostProcessorsAfterInitialization的调用。 五、需要理解的设计思想模板方法模式refresh()本身就是一个模板方法定义了大流程一些步骤如postProcessBeanFactory、onRefresh留给子类实现以适应不同环境。工厂方法模式obtainFreshBeanFactory()通过refreshBeanFactory()创建具体的 BeanFactory 实现。观察者模式通过事件发布/监听机制实现容器内各组件之间的解耦。策略模式BeanFactoryPostProcessor和BeanPostProcessor允许用户插入自定义逻辑改变 Bean 的定义或实例化过程。 六、阅读过程中可能遇到的难点难点解释循环依赖解决三级缓存singletonFactories是关键理解“提前暴露”的含义。建议结合 debug 看缓存变化。BeanPostProcessor 的执行时机区分两类在registerBeanPostProcessors中注册在 Bean 实例化前后执行。FactoryBean 和普通 Bean注意前缀理解getObject()的调用时机。AOP 代理的创建通常由AnnotationAwareAspectJAutoProxyCreator在postProcessAfterInitialization中创建代理。事件机制事件广播器的初始化、监听器的注册、事件的发布流程。 七、最后的小建议不要试图一次性读懂所有细节先抓住主线Bean 的创建再分支探索如 AOP、事务、Web 启动。结合 Spring 官方文档文档中对 IoC 容器的解释可以帮助你理解设计意图。多画图画出流程时序图或状态图有助于形成整体认知。按照这个拆解方法相信你能够逐步攻破refresh()方法从而掌握 Spring 容器的核心精髓。