深入理解 Spring ApplicationContext 的 refresh() 方法：容器启动的核心流程

文章目录深入理解 Spring ApplicationContext 的 refresh() 方法容器启动的核心流程一、refresh() 方法概览二、关键步骤详解与调试要点步骤 1prepareRefresh() —— 初始化上下文环境步骤 2obtainFreshBeanFactory() —— 创建 BeanFactory步骤 3prepareBeanFactory(beanFactory) —— 配置标准特性步骤 5invokeBeanFactoryPostProcessors() —— 执行 BFPP步骤 6registerBeanPostProcessors() —— 注册 BPP步骤 11finishBeanFactoryInitialization() —— 初始化单例 Bean步骤 12finishRefresh() —— 发布事件三、代码示例自定义扩展 refresh 流程场景在 Web 容器启动后初始化缓存四、常见问题与解决方案❌ 问题 1Bean 循环依赖导致启动失败❌ 问题 2自定义 BFPP 未按预期执行❌ 问题 3refresh() 被多次调用导致重复初始化五、最佳实践与注意事项✅ 推荐做法⚠️ 注意事项六、总结上周热门博文深入理解 Spring ApplicationContext 的 refresh() 方法容器启动的核心流程在 Spring 应用中ApplicationContext.refresh()是整个 IoC 容器初始化与启动的“总开关”。无论是基于 XML 的ClassPathXmlApplicationContext还是注解驱动的AnnotationConfigApplicationContext亦或是 Spring Boot 中的SpringApplication.run()最终都会调用refresh()方法来完成上下文的构建。本文将系统剖析refresh()方法的 12 个关键步骤结合源码、典型问题与调试技巧帮助开发者深入理解 Spring 容器的启动机制。一、refresh() 方法概览refresh()定义于ConfigurableApplicationContext接口在AbstractApplicationContext中实现。其整体流程如下简化版Overridepublicvoidrefresh()throwsBeansException,IllegalStateException{synchronized(this.startupShutdownMonitor){// 1. 准备刷新prepareRefresh();// 2. 创建并初始化 BeanFactoryConfigurableListableBeanFactorybeanFactoryobtainFreshBeanFactory();// 3. 配置 BeanFactory 的标准特性prepareBeanFactory(beanFactory);try{// 4. 允许子类进一步定制 BeanFactorypostProcessBeanFactory(beanFactory);// 5. 调用所有 BeanFactoryPostProcessorinvokeBeanFactoryPostProcessors(beanFactory);// 6. 注册所有 BeanPostProcessorregisterBeanPostProcessors(beanFactory);// 7. 初始化消息源国际化initMessageSource();// 8. 初始化事件广播器initApplicationEventMulticaster();// 9. 留给子类扩展如 Web 容器初始化 ServletContextonRefresh();// 10. 注册监听器registerListeners();// 11. 实例化所有非懒加载的单例 BeanfinishBeanFactoryInitialization(beanFactory);// 12. 完成刷新发布 ContextRefreshedEventfinishRefresh();}catch(BeansExceptionex){destroyBeans();// 失败时销毁已创建的 BeancancelRefresh(ex);throwex;}}}设计原则模板方法模式refresh()是骨架关键步骤由子类或回调扩展失败安全任何阶段异常都会触发destroyBeans()避免资源泄漏。二、关键步骤详解与调试要点步骤 1prepareRefresh() —— 初始化上下文环境设置启动时间戳标记active true初始化属性源如environment。✅调试建议在此处可检查Environment是否包含预期的配置文件如application-dev.yml。步骤 2obtainFreshBeanFactory() —— 创建 BeanFactory调用refreshBeanFactory()由子类实现如GenericApplicationContext直接返回已有DefaultListableBeanFactory返回一个“新鲜”的BeanFactory。注意FileSystemXmlApplicationContext会在此阶段加载 XML 文件并注册 BeanDefinition。步骤 3prepareBeanFactory(beanFactory) —— 配置标准特性向BeanFactory注册关键组件ClassLoaderBeanExpressionResolver支持 SpELPropertyEditorRegistrar核心 Aware 接口支持如ApplicationContextAwareProcessor忽略某些接口的自动装配如BeanFactoryAware。beanFactory.addBeanPostProcessor(newApplicationContextAwareProcessor(this));beanFactory.ignoreDependencyInterface(EnvironmentAware.class);✅影响此步骤决定了后续Autowired ApplicationContext是否生效。步骤 5invokeBeanFactoryPostProcessors() —— 执行 BFPP这是配置类解析、ConfigurationProperties 绑定、占位符替换的关键阶段。ConfigurationClassPostProcessor解析Configuration、ComponentScan、ImportPropertySourcesPlaceholderConfigurer替换${...}占位符自定义BeanDefinitionRegistryPostProcessor优先执行。⚠️常见问题若自定义BFPP未被调用检查是否正确注册为Component或通过Import引入。步骤 6registerBeanPostProcessors() —— 注册 BPP按优先级排序并注册所有BeanPostProcessor包括AutowiredAnnotationBeanPostProcessor处理AutowiredCommonAnnotationBeanPostProcessor处理PostConstructAnnotationAwareAspectJAutoProxyCreatorAOP 代理入口。重要顺序AOP 代理器必须在普通 BPP 之后注册否则无法拦截初始化后的 Bean。步骤 11finishBeanFactoryInitialization() —— 初始化单例 Bean冻结 BeanDefinition禁止后续修改调用beanFactory.preInstantiateSingletons()按依赖顺序实例化所有非懒加载的 singleton Bean。✅性能瓶颈点大型应用在此阶段耗时最长可通过Lazy延迟初始化非关键 Bean。步骤 12finishRefresh() —— 发布事件启动LifecycleBean如SmartLifecycle.start()发布ContextRefreshedEvent注册 MBeanJMX 支持。// 监听上下文刷新完成ComponentpublicclassStartupListener{EventListenerpublicvoidonContextReady(ContextRefreshedEventevent){System.out.println(ApplicationContext is ready!);}}三、代码示例自定义扩展 refresh 流程场景在 Web 容器启动后初始化缓存publicclassCustomWebApplicationContextextendsAnnotationConfigServletWebServerApplicationContext{OverrideprotectedvoidonRefresh(){super.onRefresh();// 必须调用父类// 此时 ServletContext 已可用initCacheManager();}privatevoidinitCacheManager(){// 从 ApplicationContext 获取 Bean 并初始化CacheServicecachegetBean(CacheService.class);cache.warmUp();}}✅适用场景onRefresh()是 Web 应用集成 Servlet 容器的标准扩展点。四、常见问题与解决方案❌ 问题 1Bean 循环依赖导致启动失败现象BeanCurrentlyInCreationException: ... requested by circular reference原因构造器注入的循环依赖Spring 无法解决原型prototypeBean 的循环依赖。✅解决方案改用 setter 或 field 注入使用Lazy打破依赖链重构设计消除强耦合。ServicepublicclassA{LazyAutowiredprivateBb;// 延迟初始化 B}❌ 问题 2自定义 BFPP 未按预期执行原因BFPP 本身依赖了尚未注册的 Bean未实现PriorityOrdered导致执行顺序靠后。✅修复方式ComponentpublicclassMyBFPPimplementsBeanDefinitionRegistryPostProcessor,PriorityOrdered{OverridepublicintgetOrder(){returnOrdered.HIGHEST_PRECEDENCE;// 最高优先级}OverridepublicvoidpostProcessBeanDefinitionRegistry(BeanDefinitionRegistryregistry){// 在其他 BFPP 之前执行}}❌ 问题 3refresh() 被多次调用导致重复初始化风险refresh()不是幂等的多次调用会抛出IllegalStateException。✅安全做法确保每个ApplicationContext只调用一次refresh()使用ConfigurableApplicationContext.isRunning()判断状态在测试中使用DirtiesContext控制上下文生命周期。五、最佳实践与注意事项✅ 推荐做法避免在 BFPP/BPP 中执行耗时操作会阻塞容器启动关键初始化逻辑放在ContextRefreshedEvent监听器中此时所有 Bean 已就绪使用DependsOn显式控制 Bean 初始化顺序而非依赖隐式顺序生产环境开启spring.main.lazy-initializationtrueSpring Boot 2.2加速启动。⚠️ 注意事项refresh()是同步且阻塞的不要在 Web 请求线程中调用子类重写onRefresh()必须调用super.onRefresh()容器关闭时需调用close()否则单例 Bean 的PreDestroy不会执行。六、总结ApplicationContext.refresh()是 Spring 容器的“生命之源”它以清晰的阶段划分和扩展点设计支撑了从简单配置到复杂企业应用的初始化需求。理解其 12 个步骤的职责与交互不仅能帮助我们高效排查启动问题也为自定义容器行为如多租户、动态模块加载提供了坚实基础。建议结合调试在refresh()各步骤设断点与日志开启logging.level.org.springframeworkDEBUG逐步掌握这一核心机制。在深入原理之后你将能更自信地驾驭 Spring 应用的生命周期。上周热门博文Spring 事务源码导读从 Transactional 到底层数据库提交的完整流程Spring 中不同 Scope 的 Bean 创建机制详解Spring XML 配置中import标签的解析机制与最佳实践Spring XML 解析中的 Document 加载与 EntityResolver 机制详解