外观
03 - getBean() 背后的单例 Bean 创建链路
适用版本:Spring Framework 6.x。本文以默认单例作用域为主。
前置阅读:02 - 一个 @Component 如何变成 BeanDefinition。本文从“定义已经存在”开始,不重复组件扫描和配置类解析。
摘要
调用 getBean() 时,目标对象可能已经存在,也可能只有创建它的定义。对于默认单例,容器会复用已经创建好的实例;尚未创建时,则按定义创建对象,并获取它需要的依赖。本文先建立这个基本模型,再沿 doGetBean()、createBean() 与 doCreateBean() 解释创建过程,帮助定位 Bean 创建失败和启动卡顿。
1. 场景:错误明明在 Client,为什么 Controller 也失败
text
orderController
-> orderService
-> paymentClient
-> endpoint 配置非法上图是依赖关系示意:Controller 需要 Service,Service 又需要 Client。假设 paymentClient 在创建时检查 endpoint 配置,并因配置非法而失败,那么 orderService 无法取得必需的 Client,orderController 也就无法取得 Service。
Spring 在创建非懒加载单例时,会沿这样的依赖关系继续获取其他 Bean;尚未创建的依赖也会进入创建流程。这就是依赖的递归创建。底层失败会使上层创建无法完成,异常随调用链逐层包装。因此,多个 Bean 报错可能来自同一个底层原因。排障时应沿异常中的 Caused by 向内查找有业务意义的原因。
2. getBean() 不是简单查 Map
先区分容器中的两类信息:**BeanDefinition(Bean 定义)**是创建说明,描述对象类型、创建方式和作用域;Bean 实例是按说明创建出的实际对象。BeanFactory 是负责获取和创建 Bean 的容器接口,单例缓存则保存可复用的单例对象。定义存在,不代表实例已经存在,也不保证创建一定成功。
**作用域(Scope)**决定实例如何共享。默认的 singleton(单例)通常表示:在同一个 BeanFactory、同一个 Bean 名称下共享一个实例。因此,单例缓存未命中时需要创建,创建成功后的重复获取通常复用同一对象。
下面以按名称获取 Bean 为主,省略异常处理等分支。按类型获取还需要先确定目标 Bean,不能把它理解成直接按类型查这个缓存。
图表将在阅读到此处时加载…
dependsOn 表示定义中显式声明的先行依赖:容器先获取这些 Bean,再创建当前 Bean。它与构造器参数、字段等注入点所表达的依赖不同。类型适配则是在调用方指定返回类型时,检查或转换获取结果,使其满足类型要求。
阅读源码时,可以按职责关注以下入口:
AbstractBeanFactory#doGetBean:组织一次获取流程;DefaultSingletonBeanRegistry#getSingleton:获取或管理单例对象;AbstractAutowireCapableBeanFactory#createBean:进入创建流程,并处理实例化前的扩展机会;AbstractAutowireCapableBeanFactory#doCreateBean:执行常规对象创建主线。
doGetBean() 处理的范围比 doCreateBean() 更大:前者负责名称、缓存、父容器、Scope 和类型适配,后者只负责一次具体的 Bean 创建。排查时不要把所有异常都笼统归为 doCreateBean()。
2.1 Bean 名称转换与父容器边界
调用方传入的名称可能是别名,也可能带有 FactoryBean 解引用前缀 &。FactoryBean 是由容器管理、负责生产其他对象的工厂接口;解引用表示获取工厂本身,而非它生产的对象,第 6 节会说明两种返回值。容器查找缓存和定义时,会先去掉这类前缀并解析别名,得到规范 Bean 名;返回时仍按调用方是否使用 & 决定取工厂还是产品。
父容器是当前容器向上委托查找的另一个容器。容器先检查本地单例缓存和本地定义;只有本地没有相应定义且存在父容器时,才可能委托查找。委托不保证成功,父容器仍可能找不到目标 Bean。
父子容器可以各自拥有同名 Bean。子容器的本地定义会遮蔽父容器定义,因此“父容器明明有这个 Bean”并不能证明子容器按类型或名称一定会取到预期对象。
2.2 合并 BeanDefinition
真正创建前,Spring 会得到合并后的 BeanDefinition。这里的父子定义是创建说明之间的继承关系,与上一节的父子容器不是同一个概念。子定义可以继承父定义的作用域、构造参数、属性值和生命周期元数据;合并就是整理出创建当前 Bean 所需的完整说明。注解配置中虽然较少直接使用父子定义,框架内部仍统一通过合并后的定义驱动创建。
因此调试时应关注 merged definition(合并后的定义),而不只是最初注册的定义。定义后处理器可以在实例创建前修改创建说明,所以最终使用的配置也可能与类上注解的表面信息不同。
3. 单个 Bean 如何被创建
doCreateBean() 可以概括为三大阶段:
createBeanInstance(实例化):选择构造器或工厂方法,准备参数并创建对象;populateBean(属性填充):处理字段、setter 等注入点和定义中的属性值;initializeBean(初始化):调用容器约定的回调和后处理器,让对象完成初始化。
构造器和工厂方法的参数必须在调用前准备好,所以依赖解析也可能发生在第一阶段,不能把所有依赖注入都归入属性填充。下面的时序图展示对象已实例化后,还需要填充属性的主线。
Aware 是一组让 Bean 接收容器信息的回调接口,例如接收自身名称或所属 BeanFactory。BeanPostProcessor(Bean 后处理器)则是加工 Bean 实例的扩展接口,可以在初始化前后参与处理。后处理器还可能返回代理对象,即由另一个对象转发对目标 Bean 的调用,以加入额外行为。
图表将在阅读到此处时加载…
三个阶段对应不同扩展入口,可以用来缩小失败范围:
| 阶段 | 代表入口 | 典型失败 |
|---|---|---|
| 实例化 | createBeanInstance | 构造器歧义、工厂方法异常、类无法实例化 |
| 属性填充 | populateBean | 候选不存在、候选不唯一、类型转换失败 |
| 初始化 | initializeBean | Aware、@PostConstruct、init-method、后处理器异常 |
初始化中的 @PostConstruct 是初始化回调注解,init-method 是定义中指定的初始化方法。它们与 Aware、后处理器共同构成生命周期扩展点,具体顺序见阅读导航中的第 5 篇。
InstantiationAwareBeanPostProcessor 是能参与实例化和属性填充的后处理器扩展接口。它还能在实例化前返回替代对象,使创建流程不进入常规的 doCreateBean() 主线。因此,上表不代表每个 Bean 都必须执行全部步骤。
4. 为什么构造器可能选错
一个类有多个构造器时,Spring 需要结合注解、参数可解析性和版本规则选择候选。框架并不知道“带业务依赖的构造器才是作者想用的那个”。若必需依赖没有明确表达,就可能出现实际选择与预期不一致的问题。对于通常的业务组件,保留一个表达完整必需依赖的构造器更容易理解和维护。
下面是构造器设计的局部片段,需要提供 PaymentClient 类型及 @Service 导入,并将组件注册到容器。两个片段是替代写法,不应同时声明。反例提供了两种创建入口,却没有说明为何必须使用带 Client 的入口:
java
@Service
class OrderService {
OrderService() { }
OrderService(PaymentClient client) { }
}正例通过唯一构造器表达必需依赖,并用 final 保存它:
java
@Service
class OrderService {
private final PaymentClient client;
OrderService(PaymentClient client) {
this.client = client;
}
}在本文的 Spring Framework 6.x 范围内,通常的单构造器组件不需要额外标注 @Autowired。多个构造器的精确选择规则则应结合所用小版本和注解配置判断。
5. 单例何时进入缓存
正常创建路径中,单例完成初始化后会进入保存完整单例的缓存,通常称为一级缓存。后续获取复用这个结果,因此构造器和初始化回调通常不会再次执行。
循环依赖是指依赖链又回到正在创建的 Bean,例如 A 需要 B,B 又需要 A。为处理部分允许的循环依赖,Spring 还可能提前暴露对象工厂和早期引用,让另一个 Bean 在当前 Bean 完成初始化前取得引用。这里的对象工厂是用于获取早期引用的回调,不等同于第 6 节的 FactoryBean。提前拿到引用不等于对象已完成初始化,也不表示所有循环依赖都能解决;三级缓存会在第 7 篇详细解释。
也不要把所有 Scope 都套入单例缓存模型:
prototype(原型作用域)每次获取通常重新创建,容器不负责完整销毁;request/session等 Web 作用域在请求或会话范围内保存实例;- 自定义
Scope决定对象保存、移除和销毁回调策略; - scoped proxy(作用域代理)会让单例 Bean 持有代理,再由代理按当前作用域获取真实目标。
因此“同一类型为什么出现多个实例”应同时检查 Bean 名称、BeanFactory 层级和 Scope。完整的生命周期边界和作用域代理见 21 - Bean Scope 与作用域代理。
6. FactoryBean 会改变返回结果
如果名为 name 的 Bean 实现了 FactoryBean,容器中就需要区分工厂本身与工厂生产的对象:普通 getBean("name") 返回产品,getBean("&name") 返回工厂本身。产品通常通过 FactoryBean#getObject() 获取。
因此,命中单例缓存并不一定意味着可以直接返回缓存对象:缓存中取得的可能是工厂,还需要解析它的产品。工厂实例的作用域与产品是否按单例处理是两个问题,不能只凭工厂是单例就推断产品每次都相同。相关返回值和缓存规则见第 8 篇。
7. 最小示例:观察创建时机
示例需要 Java 17 及 Spring Framework 6.x 的 spring-context 依赖。将代码保存为 GetBeanDemo.java,放入已配置依赖的 Java 项目,在 IDE 中运行 main。AnnotationConfigApplicationContext 是加载 Java 注解配置的应用上下文;这里使用带配置类的构造器,构造返回时上下文已经完成刷新。
java
import org.springframework.context.annotation.AnnotationConfigApplicationContext;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.context.annotation.Lazy;
public class GetBeanDemo {
public static void main(String[] args) {
var context = new AnnotationConfigApplicationContext(AppConfig.class);
System.out.println("context ready");
context.getBean(SlowClient.class);
context.getBean(SlowClient.class); // 单例不会再次构造
context.close();
}
@Configuration
static class AppConfig {
@Bean
@Lazy
SlowClient slowClient() {
System.out.println("creating SlowClient");
return new SlowClient();
}
}
static class SlowClient { }
}@Lazy 表示延迟创建。这个示例没有其他 Bean 在刷新期间请求 SlowClient,因此保留 @Lazy 时,首次 getBean() 才调用工厂方法。只看代码中两条 System.out.println 的预期输出为:
text
context ready
creating SlowClient第二次获取复用同一单例,不会再打印创建日志。去掉 @Lazy 后,SlowClient 会在上下文刷新期间创建,两行预期输出的顺序相反。
懒加载并不保证对象一定等到业务代码显式调用 getBean() 才创建:若非懒加载 Bean 在创建时需要它,也可能提前触发获取。判断创建时机时,要同时检查依赖关系。
7.1 把观察改成可重复断言
日志便于观察,断言则能直接检查创建次数和返回对象是否相同。下面是测试方法内的局部片段:需要上一示例的 SlowClient 类型、java.util.concurrent.atomic.AtomicInteger 和 AnnotationConfigApplicationContext 导入,以及 AssertJ 测试依赖与 org.assertj.core.api.Assertions.assertThat 静态导入。它手动注册一个懒加载 Bean,不加载上一示例的 AppConfig。
java
AtomicInteger creations = new AtomicInteger();
var context = new AnnotationConfigApplicationContext();
context.registerBean(SlowClient.class, () -> {
creations.incrementAndGet();
return new SlowClient();
}, definition -> definition.setLazyInit(true));
context.refresh();
assertThat(creations).hasValue(0);
Object first = context.getBean(SlowClient.class);
Object second = context.getBean(SlowClient.class);
assertThat(creations).hasValue(1);
assertThat(first).isSameAs(second);
context.close();预期断言结果是:刷新后创建次数为 0,两次获取后创建次数为 1,且两个返回值是同一对象。
若要验证失败阶段,可分别在构造器、依赖注入后的初始化回调中注入异常,再断言最外层异常、目标 Bean 名称和最内层业务原因。实际测试应通过 try/finally 或测试框架的清理回调保证上下文关闭,即使断言失败也释放容器管理的资源,避免影响后续用例。
8. 容易踩的坑
- 在构造器里执行慢 I/O:当前 Bean 无法及时创建,上层等待它的 Bean 也无法完成创建。
- 在初始化完成前把
this发布到静态变量或线程中:其他代码可能取得尚未完成属性填充或初始化的对象。 - 把
@Lazy当作修复创建异常的方法:它只改变创建时机,错误可能延迟到首次请求才暴露。 - 把
prototype当作容器全程管理的对象:创建后还需调用方安排其资源释放。 - 只看上层
UnsatisfiedDependencyException(依赖无法满足异常):依赖不存在、候选不唯一和依赖 Bean 创建失败都需要沿异常链进一步区分。
9. 排障方法
- 找到异常中的 Bean 名称和构造参数或字段位置。
- 沿最内层有业务意义的
Caused by还原依赖链。 - 区分实例化失败、依赖填充失败和初始化回调失败。
- 对启动慢问题,检查构造器、
@PostConstruct、工厂方法是否访问外部资源。 - 调试源码时在
doCreateBean()对目标 Bean 名称设置条件断点。 - 若实例数量不符合预期,记录 Bean 名称、所属 ApplicationContext、Scope 和是否为 scoped proxy。
10. 总结
getBean() 是一条对象生产流水线的入口,而不是一次普通的 Map 查询。
- 单例未命中缓存时,
getBean()可能递归触发整条依赖链创建。 - Bean 创建包含实例化、属性填充和初始化,异常阶段不同,排查方向也不同。
- 容器最终返回的可能是后处理器生成的代理,而非最初构造的原始对象。
阅读导航
- 定义从哪里来:02 - 一个 @Component 如何变成 BeanDefinition
- 属性填充如何选择依赖:04 - Spring 如何完成依赖注入
- 初始化回调顺序:05 - Bean 生命周期与扩展点顺序
- 早期单例引用:07 - 三级缓存与循环依赖
- FactoryBean 返回值转换:08 - FactoryBean、BeanFactory 与 ObjectProvider
- 不同 Scope 怎样获得实例:21 - Bean Scope 与作用域代理