Spring Framework 的源码库采用 Gradle 多模块构建，整个项目由数十个功能边界清晰的子模块组成。理解这些模块的职责划分与包结构，是高效阅读和调试 Spring 源码的前提。本节将以 Spring Framework 5.x/6.x 的源码组织为蓝本，梳理其核心模块、关键包以及推荐的阅读路径。
26.1.1 项目模块总览
Spring 源码根目录下的 settings.gradle 定义了所有子模块。从功能域的角度，可以将其归为以下几类：
一、核心容器模块
| 模块名 | 职责 | 核心内容 |
|--------|------|----------|
| spring-core | 框架的基础工具和核心抽象 | ASM 字节码处理、注解元数据、类型转换、资源访问、序列化、通用工具类 |
| spring-beans | Bean 的定义、创建、装配 | BeanFactory、BeanDefinition、属性编辑器、Bean 后处理器 |
| spring-context | 应用上下文，扩展容器能力 | ApplicationContext、事件机制、国际化、资源加载、@Configuration 解析、SpEL 集成 |
| spring-context-support | 上下文的扩展支持 | 集成 Quartz、邮件发送、FreeMarker 模板等 |
| spring-expression | SpEL 表达式语言 | 表达式解析、求值、方法调用、变量操作 |
这五个模块是 Spring 的绝对核心。其中 spring-beans 和 spring-context 构成了 IoC 容器的两阶段模型（BeanFactory 提供基本 DI 能力，ApplicationContext 在此基础上添加上下文感知、事件发布等高级特性）。
二、AOP 与字节码增强
| 模块名 | 职责 | 核心内容 |
|--------|------|----------|
| spring-aop | 基于代理的 AOP 实现 | AopProxy、JDK 动态代理和 CGLIB 代理、切面织入、@AspectJ 注解支持 |
| spring-aspects | 集成 AspectJ，提供编译时织入 | @Configurable、加载时织入（LTW）相关切面实现 |
| spring-instrument | 类加载级别的 Instrumentation 支持 | InstrumentationSavingAgent，用于 Javaagent 场景 |
spring-aop 是声明式事务、方法级安全等特性的底层支撑。它依赖于 spring-core 的代理工具和 spring-beans 的 Bean 后处理器机制。
三、数据访问与事务
| 模块名 | 职责 | 核心内容 |
|--------|------|----------|
| spring-jdbc | 简化 JDBC 操作 | JdbcTemplate、NamedParameterJdbcTemplate、DataSourceUtils、异常层次结构 |
| spring-orm | ORM 框架集成 | 与 Hibernate、JPA 的集成支持，共享的事务管理器 |
| spring-tx | 事务抽象 | PlatformTransactionManager、TransactionDefinition、声明式事务的 AOP 切面 |
| spring-data-commons | 数据访问通用基础（属于 Spring Data 项目，非 core） | Repository 接口、分页、审计等抽象 |
spring-tx 是整个事务管理的核心，它不绑定任何具体的数据访问技术。spring-jdbc 和 spring-orm 分别提供 JDBC 和 ORM 的实现。
四、Web 层模块
| 模块名 | 职责 | 核心内容 |
|--------|------|----------|
| spring-web | 通用 Web 基础设施 | WebApplicationContext、DispatcherServlet 基础、HTTP 消息转换器、过滤器、Web 应用上下文初始化 |
| spring-webmvc | 经典的 MVC 框架（Servlet 栈） | @Controller、@RequestMapping、视图解析、数据绑定、HandlerMapping、HandlerAdapter |
| spring-webflux | 响应式 Web 框架（Reactive 栈） | RouterFunction、HandlerFunction、WebClient、响应式 HTTP 支持 |
| spring-websocket | WebSocket 支持 | STOMP 协议、WebSocket 会话管理 |
五、测试模块
| 模块名 | 职责 | 核心内容 |
|--------|------|----------|
| spring-test | 测试支持工具 | @SpringBootTest（实现在 Boot 中，但 spring-test 提供了核心上下文缓存）、MockMvc、TestContext 框架、Mockito 支持 |
六、其他支撑模块
还有 spring-oxm（对象 XML 映射）、spring-jms（JMS 消息）、spring-messaging（消息处理抽象）等，它们为特定技术领域提供 Spring 风格的编程模型。
26.1.2 关键包结构剖析
以 spring-beans 和 spring-context 为例，查看源码中包的组织方式，可以快速定位关注的类。
spring-beans 模块的包结构（部分）
org.springframework.beans
├── factory // 核心工厂接口与实现
│ ├── BeanFactory // IoC 容器顶层接口
│ ├── ListableBeanFactory
│ ├── HierarchicalBeanFactory
│ ├── AutowireCapableBeanFactory
│ ├── ConfigurableBeanFactory
│ ├── xml // XML 配置解析
│ ├── support // 具体实现，如 DefaultListableBeanFactory
│ ├── annotation // 注解驱动的 Bean 后处理器
│ └── config // BeanDefinition 的配置抽象
├── BeanDefinition // Bean 定义接口
├── BeanMetadataElement
├── PropertyEditorRegistry // 属性编辑器注册
└── ... (异常类、属性访问器等)整个 IoC 体系的入口在 BeanFactory 接口，但实际开发中直接使用的是其孙子接口 ApplicationContext（定义在 spring-context 中）。DefaultListableBeanFactory 是 Spring 中最核心的 IoC 容器实现类，它同时继承了 BeanFactory 和 BeanDefinitionRegistry。
spring-context 模块的包结构（部分）
org.springframework.context
├── ApplicationContext // 核心应用上下文接口
├── ConfigurableApplicationContext
├── event // 事件发布与监听
├── annotation // @Configuration, @ComponentScan 解析
└── support // ApplicationContext 的实现类
org.springframework.stereotype // @Component, @Service 等原型注解
org.springframework.cache // 缓存抽象（@Cacheable 等）
org.springframework.scheduling // 定时任务（@Scheduled）spring-context 模块将 IoC 容器提升为一个功能完备的运行时环境，事件机制、资源管理、注解配置解析均在此实现。ClassPathXmlApplicationContext 和 AnnotationConfigApplicationContext 是两个最典型的独立实现。
26.1.3 阅读源码的实用路径
面对上百万行代码，需要有重点、有策略地切入。以下是经验证明有效的阅读路径：
第一步：从容器启动流程入手
选择一个简单的 AnnotationConfigApplicationContext 启动流程，断点步入 refresh() 方法。refresh() 是容器初始化的核心，它包含了几乎全部关键步骤：BeanDefinition 的加载与注册、BeanFactoryPostProcessor 的执行、BeanPostProcessor 的注册、单例 Bean 的实例化等。理解 refresh() 就等于抓住了容器的脉络。
第二步：深入 Bean 的生命周期
在 DefaultListableBeanFactory 中追踪一个单例 Bean 的创建流程：getBean() → doGetBean() → createBean() → doCreateBean()。观察 BeanPostProcessor 在各个环节（实例化前、初始化前、初始化后）如何介入，理解 @Autowired、@PostConstruct 等注解是如何被处理的。
第三步：剖析 AOP 代理的生成与织入
找到 AbstractAutoProxyCreator 及其子类，它是 AOP 与容器结合的桥梁。它作为一个 BeanPostProcessor，在 Bean 初始化后检查是否有切面需要代理，并通过 ProxyFactory 动态创建代理对象。结合 @Transactional 事务注解的处理，可以看到 InfrastructureAdvisorAutoProxyCreator 是如何完成对事务切面的自动匹配。
第四步：阅读 Web 请求处理链路
从 DispatcherServlet.doDispatch() 开始，跟踪一个 HTTP 请求如何被 HandlerMapping 匹配到具体的 Controller 方法，经过 HandlerAdapter 调用，最后通过 ViewResolver 渲染或直接由 HttpMessageConverter 输出 JSON。在这个过程中，拦截器（HandlerInterceptor）、异常处理器（HandlerExceptionResolver）等的运作机制也将变得清晰。
第五步：参考 Spring 官方文档和 Javadoc
Spring 源码中的 Javadoc 质量非常高，很多设计动机在接口或类的注释中有直接说明。阅读源码时，将 Javadoc 与代码实现对照，能更快理解设计意图而非仅仅停留在“如何实现”的层面。
26.1.4 源码阅读工具与技巧
- IDE 导航：使用 IntelliJ IDEA 的类图可视化（Ctrl+Alt+U）理解接口继承体系，使用 Find Usages（Alt+F7）查看某个类或方法在框架内部如何被调用。
- 断点调试：在
refresh()、getBean()等关键方法打断点，结合 Step Into/F8 逐行执行，观察变量变化。 - 日志辅助：将
org.springframework.beans和org.springframework.context的日志级别设为 DEBUG，可以在控制台看到容器启动时的详细步骤，辅助理解流程。 - 画出调用图：对于复杂的链路（如事务织入），手工绘制一张从切面定义到最终代理调用的流程图，往往比反复调试更高效。
Spring Framework 的源码结构虽然庞大，但模块职责和包组织遵循严格的逻辑分层。一旦熟悉了核心模块的边界和关键类的定位，整个框架就不再是一个黑盒，而是一本可以翻开查阅任何一页的技术手册。接下来，我们将从 ApplicationContext 的启动流程开始，实际进入 Spring 源代码的深度解析。