ARTICLE · 1361127
1.3 如何阅读 Spring 源码:从入口到调用链
源码阅读不是逐行翻译
第一次读 Spring 源码,很容易陷入两种困境:要么从某个类的第一行开始,越读越迷路;要么只记住几个类名,却说不清一次调用究竟怎样发生。更有效的方法,是带着一个具体问题进入源码,用入口建立路线,用关键对象串起流程,再用实验检查自己的理解。
这一节用“创建应用上下文并取得一个 Bean”作为练习。初学者先掌握对象与流程;有经验的开发者关注职责边界和条件分支;进阶读者则学习如何从公开入口追踪到基础设施实现。
动手前先问四个问题
1.我要解释的现象是什么?例如:创建 AnnotationConfigApplicationContext 时,配置类什么时候注册?
2.调用从哪里开始?优先找用户实际调用的构造器、公开方法或接口,而不是随机挑一个内部类。
3.谁负责下一步?沿调用者与被调用者的关系,标记每个对象的职责。
4.我怎样证实结论?用源码条件、断点、日志或最小实验验证,不凭方法名猜行为。
建议随手记下“问题—入口—关键对象—下一跳—证据”五项。它比抄一大段源码更有助于建立自己的源码地图。
先选一个清楚的入口
先看一个很小的使用场景。下面的 GreetingService 通过 @Bean 方法注册为容器 Bean:
AnnotationConfigApplicationContext context =new AnnotationConfigApplicationContext(AppConfig.class);GreetingService service = context.getBean(GreetingService.class);service.greet();context.close();
读者可以先问:构造器收到 AppConfig.class 后做了什么?调用 getBean 时由谁返回对象?上下文关闭后又发生什么?本节主要追踪前两个问题;销毁回调会在 Bean 生命周期章节专门展开。
在本地源码中,AnnotationConfigApplicationContext 提供了接收配置类的构造器。阅读它时,先确认构造器执行顺序,再分别跟进 register 与 refresh。不要从某个看起来“很核心”的底层工具类开始猜整体流程。
第一条调用链:配置类到上下文刷新
把构造器缩写成一张路线图:
new AnnotationConfigApplicationContext(AppConfig.class)├─ 初始化注解 Bean 定义读取器和类路径扫描器├─ register(AppConfig.class)│ └─ 将配置类登记为容器可处理的定义└─ refresh()├─ 准备上下文并取得 BeanFactory├─ 准备 BeanFactory,执行相关后处理├─ 初始化剩余的非延迟单例 Bean└─ 完成刷新
这张图只呈现帮助理解的主线,并非每个内部方法的完整调用清单。AnnotationConfigApplicationContext 的构造器负责把配置类交给注册流程并刷新上下文;AbstractApplicationContext.refresh() 则组织刷新阶段。具体注册细节、扩展点和异常处理要回到相应源码继续核对。
刷新阶段中,BeanFactoryPostProcessor 可以在 Bean 实例化前处理 Bean 定义;BeanPostProcessor 则参与 Bean 创建过程。它们名字相近,但作用阶段不同。此处只把它们放进路线图,后续章节再通过源码逐个拆解。
第二条调用链:getBean 到对象创建
上下文刷新后,示例调用 getBean(GreetingService.class)。从 ApplicationContext 的 BeanFactory 委托路径继续追踪,可以看到 AbstractBeanFactory 中的 getBean(String) 进入 doGetBean;当对象尚未从已创建对象中取得、且需要创建时,流程会进入 createBean。创建的具体工作由可自动装配的 BeanFactory 层实现。
context.getBean(GreetingService.class)→ BeanFactory 的按类型查找路径→ AbstractBeanFactory.getBean(...) / doGetBean(...)→ AbstractAutowireCapableBeanFactory.createBean(...)→ doCreateBean(...)→ 完成实例化、依赖处理与初始化等创建工作
注意:这不是每次 getBean 都会完整执行的固定路线。若单例已经创建,容器可能直接返回缓存对象;如果查找的是 FactoryBean,或者涉及父容器、作用域、代理和后处理器,路线也会增加分支。因此源码讲解应说清“在什么条件下走这条路径”,而不只罗列方法名。
另一个重要区别:BeanDefinition 是描述 Bean 的元数据,不是 Bean 实例本身。可以把定义理解为“配方”,实例理解为“按配方准备好的对象”。容器可以先读取和处理定义,再按需创建实例。
把调用链读准:四个实用动作
动作一:从公开入口开始,逐步下钻
优先选择应用代码真正调用的构造器或方法,再跟踪它调用的下一层。每进入一层,先读类职责和方法注释,再读主体;遇到不相关的辅助逻辑时先记下位置,不要立即展开全部细节。
动作二:同时看调用方和被调用方
单独阅读方法定义只能看到局部实现。回到调用方,确认调用发生的条件、传入了什么对象,以及调用完成后谁继续处理。调用方解释“为什么这里调用”,被调用方解释“调用后做什么”。
动作三:用断点验证对象身份和时间顺序
在构造器、register、refresh、getBean 和 createBean 设置断点,记录对象类型、Bean 名称以及调用堆栈。小步调试比一次性跟进几十层调用更有效;观察到的路径要附上触发条件,避免把某个实验结果误认为所有场景。
动作四:把证据写成可复查的笔记
记录仓库版本、文件路径、方法名和结论。源码行号会随着版本变化,重要引用应同时记录版本或提交信息;当前本地源码的 gradle.properties 标记为 7.1.0-SNAPSHOT,目录没有 Git 元数据,因此本节不声称某个可验证的 Git 提交号。
练习:自己画出一条最小 Bean 路线
请用你熟悉的 IDE 打开本地源码,完成以下练习:
5.找到 AnnotationConfigApplicationContext(Class<?>... componentClasses) 构造器,写出它调用的主要步骤。
6.找到 AbstractApplicationContext.refresh(),把内部流程归纳为 4 至 6 个阶段。
7.找到 AbstractBeanFactory.getBean(String) 以及 doGetBean,判断什么情况下会创建新对象。
8.用同一个上下文连续 getBean 两次,比较返回对象是否相同,并解释这个实验适用的作用域条件。
9.在调试器中记录一次 getBean 的调用栈;再将容器关闭,观察关闭路径与 Bean 销毁相关回调。
实验提示:第 4 步应明确限定为默认单例 Bean 等条件;不要只凭一次对象相同就推论所有 Bean 都是单例。第 5 步的销毁流程将在生命周期章节展开,本节先练习找到入口并记录路径。
给不同阶段读者的检查清单
·入门读者:能解释配置类、BeanDefinition、Bean 实例和 BeanFactory 的区别。
·初级读者:能从构造器追踪到 register 与 refresh,说明上下文何时开始工作。
·中级读者:能区分 BeanFactoryPostProcessor 与 BeanPostProcessor 的介入阶段。
·高级读者:能结合缓存命中、作用域和扩展点说明 getBean 路径为何存在分支。
·教师或培训者:能把“现象—流程图—源码证据—动手验证”组织为一段可重复的课堂练习。
本节小结
读 Spring 源码的关键,不是记住最多的类名,而是能够从真实入口出发,沿调用链识别关键对象和职责,区分主线与条件分支,并通过调试或实验验证推断。下一节将进一步深入容器启动:配置如何转化为 BeanDefinition,以及容器为何要在实例化之前先处理这些定义。















































































