← 课程目录 🚀 从零到一
📐 学习维度 阶段7 · 第28章 开源项目源码精读 🚀 从零到一 📚 课程目录 🏠 首页 🛤️ 学习路径

28.12.1 Spring Framework:容器启动流程与 refresh 十二步

审校 2026-09-26 · 素材来源:zcode会话《原理图讲解大纲》(项目源码分析)
📑 本篇章节导航 (共7节,点击直达)
场景:main 方法里那行 run 到底干了什么类比:开一家餐厅可跑示例:观察启动各阶段原理拆解:主线四段踩坑清单面试怎么问补充:把注解钉回 refresh 时间轴

面试官问「Spring 怎么启动的」,大多数人只会答一句「调 refresh」。这篇把启动主线拆开讲:从 run 方法到 BeanDefinition 注册,说清楚每一步在干嘛、每一步埋着哪些后续专题的伏笔。

前置阅读:13.1 走过启动五步,27.1 手写过 IoC 骨架。这篇按源码把 refresh 十二步钉死。

场景:main 方法里那行 run 到底干了什么

你写了个最简启动类,SpringApplication.run(App.class, args) 一跑,控制台横幅一闪,几十个 bean 就绪。看似一行,实际背后是十几步流水线。

出问题时你就得知道这行代码拆开是什么。比如启动报「找不到某个 BeanDefinition」,你得知道它本该在哪一步注册;想在所有 bean 创建之前改点配置,你得知道该挂在哪一步;想监听「容器就绪」做预热,你也得知道事件在哪一步发布。

很多人学了两年 Spring,脑中的启动流程还是一团浆糊,就是因为从来没把这条主线走通过。主线通了,AOP、事务、事件这些专题,全都只是主线上某一步的放大镜。

类比:开一家餐厅

ApplicationContext(应用上下文,Spring 容器的门面,提供 getBean、事件、环境抽象等能力)是餐厅,BeanFactory(bean 工厂,真正存取 bean 的底层容器)是后厨。

启动流程就是:装修店面(准备容器)→ 贴招聘启事(包扫描,收集图纸)→ 审核改造菜单(BFPP 改图纸)→ 招齐员工(创建单例 bean)→ 开门营业(发布事件、回调 Runner)。

有一个关键认知要先立住:先收集所有图纸,再统一施工。Spring 不是扫到一个类就 new 一个,而是先把全项目的类信息都登记成图纸,核对完图纸再统一造对象。这个「图纸先行」的设计,是后面一切扩展点能工作的前提。

可跑示例:观察启动各阶段


@SpringBootApplication
public class App {
    public static void main(String[] args) {
        ConfigurableApplicationContext ctx =
            SpringApplication.run(App.class, args);
        // 启动完成后,单例池里应该有userService
        System.out.println(ctx.getBean("userService"));
    }
}

// 用事件监听器观察启动时间轴
@Component
class Timeline {
    @EventListener
    public void onReady(ContextRefreshedEvent e) {
        System.out.println("容器刷新完成,所有单例就绪");
    }
}

想看得更细,把断点打在 AbstractApplicationContext.refresh() 第一行,调用栈能一路回溯到 SpringApplication.run;再配合 -Ddebug 或事件监听器,就能把整个启动时间轴串起来。

原理拆解:主线四段

第一段:SpringApplication 构造。这一段做三件事:推断应用类型(Servlet Web / Reactive / 普通非 Web,决定后面 new 哪种容器);从 spring.factories 加载 ApplicationContextInitializer 和 ApplicationListener;从调用栈推断出主启动类。

第二段:createApplicationContext。按应用类型创建容器,比如 Servlet Web 应用会 new 出 AnnotationConfigServletWebServerApplicationContext。这里要记牢继承体系:ApplicationContext 并不是 BeanFactory 的替代品,而是组合了它;整个体系里唯一真正的 BeanFactory 实现是 DefaultListableBeanFactory——它内部的 ConcurrentHashMap 就是单例池(singletonObjects,存成品 bean 的池子),而 beanDefinitionMap 存的是图纸。两个 Map,一个存类信息,一个存对象,别混。

第三段:refreshContext,核心中的核心。AbstractApplicationContext.refresh() 固定十二步,是个模板方法,子类只能按这个顺序走。挑最要紧的几步:

第四段:回调 Runner。refresh 结束后,SpringApplication 依次回调容器里所有的 ApplicationRunner、CommandLineRunner,最后发布 ApplicationReadyEvent。想在上岗前干点初始化活,Runner 是正位。

把这四段压成一句话:构造推断 → 建容器 → refresh 十二步(第 5 步收图纸、第 6 步装质检员、第 11 步统一施工)→ 回调 Runner 开门营业。

踩坑清单

面试怎么问

「描述 Spring 容器启动流程?」——答:SpringApplication.run 先构造推断应用类型,创建对应 ApplicationContext,进入 refresh 十二步;第 5 步 BFPP 完成配置类解析与包扫描、注册 BeanDefinition,第 6 步注册 BeanPostProcessor,第 11 步 preInstantiateSingletons 创建全部非懒加载单例,最后回调 Runner 并发布就绪事件。

「BeanFactory 和 ApplicationContext 什么关系?」——答:组合关系,ApplicationContext 在 BeanFactory 之上叠加了事件发布、国际化、资源加载;底层唯一实现是 DefaultListableBeanFactory,单例池和 BeanDefinition 注册表都在它身上。

补充:把注解钉回 refresh 时间轴

学 Spring 最有效的收尾动作,是把常用注解逐个钉回启动时间轴上,看它们各自在哪一步生效:

这张表建议手抄一遍。之后遇到任何「某注解为什么不生效」的问题,先回到时间轴定位它的生效点位,再顺着点位查上下游,比盲目搜索快得多。也是讲课或带新人时最好用的收尾总结。

「@Bean 方法什么时候执行?」——答:方法所在的配置类本身在第 5 步被解析注册,@Bean 对应的 bean 在第 11 步统一创建时才真正调用方法生成对象。