外观
05 - Bean 生命周期与扩展点顺序
适用版本:Spring Framework 6.x、Jakarta Annotations。Spring 6 使用
jakarta.annotation命名空间。
前置阅读:03 - getBean() 背后的单例 Bean 创建链路和04 - Spring 如何完成依赖注入。本文讨论单个 Bean,不把容器刷新事件和 Boot 就绪事件混入同一时间线。
摘要
Bean 生命周期,是容器从创建对象、准备依赖、执行初始化,到最终清理资源的过程。回调是容器在指定阶段调用的方法,让对象有机会校验配置或释放资源。
理解这条主线,可以回答两个常见问题:为什么 @PostConstruct 中字段已经注入,事务调用却可能不生效;为什么初始化方法执行了,销毁方法却没有执行。关键是区分目标对象、容器最终提供的引用,以及容器负责管理的范围。
1. 场景:为什么 @PostConstruct 能拿到依赖,却拿不到最终代理
Spring 先创建对象,再完成字段和方法注入,随后执行初始化回调。构造器注入更早:参数必须在调用构造器前准备好。因此,在常规创建流程中,@PostConstruct 执行时依赖通常已经就位;这不意味着其他 Bean 或整个应用都已准备完成。
AOP(面向切面编程)通过代理在方法调用前后加入事务等行为。代理是转发调用的对象,被转发到的业务对象称为目标对象。初始化回调通常在目标对象上执行,此后后处理器仍可能把它包装为代理,容器最终提供的引用便可能不同于初始化时的 this。
所以,“依赖已经注入”和“调用已经经过代理”是两件事。初始化方法通过 this 调用本类方法,不会因为稍后创建了代理,就自动绕到代理上。这里讨论常规 Spring AOP 代理流程,循环依赖中的早期引用另有分支。
2. 生命周期主线
图表将在阅读到此处时加载…
图中展示普通 Bean 的常规流程,销毁部分以容器负责管理该对象、且正常进入关闭流程为前提。BeanPostProcessor(Bean 后处理器)是容器加工实例的扩展接口,初始化前后各有一条处理器链。@PostConstruct 由其中的注解处理器调用,并不是等所有初始化前处理器结束后再执行的独立步骤;自定义处理器在它之前还是之后运行,取决于实际处理器顺序。
三类初始化回调分别是:@PostConstruct 注解方法、InitializingBean 接口的 afterPropertiesSet() 方法,以及通过配置指定的 init-method。对于示例中分别声明的三个方法,常规顺序如图所示。@PreDestroy、DisposableBean.destroy() 和自定义 destroy-method 则是对应的资源清理入口。精确行为仍需结合目标版本、已注册处理器和 Bean 配置判断。
还应区分三个容易混淆的完成点:
text
Bean 初始化完成
≠ ApplicationContext refresh 完成
≠ Spring Boot 应用已经 ready一个 Bean 初始化完成后,ApplicationContext(应用上下文)还可能继续创建其他单例。refresh() 是上下文的刷新与启动流程,涉及多个 Bean 和容器级事件;Lifecycle 是表达组件启动、停止能力的接口,自动启动需结合具体实现与容器配置。Spring Boot 还会执行 Runner,即应用启动阶段的任务接口,然后才进入应用就绪阶段。容器级扩展时机见 18 - Spring 扩展点选型与执行顺序。
3. 最小示例
以下代码展示回调类和注册方法,需要 Spring Framework 6.x 的 spring-context 与 Jakarta Annotations API。@Bean 方法需放在已注册的配置类中,并导入 org.springframework.context.annotation.Bean。假设使用支持注解处理的 ApplicationContext、生命周期注解处理器已注册、没有自定义处理器截断流程,且上下文正常关闭。片段不包含创建和关闭上下文的入口。
java
import jakarta.annotation.PostConstruct;
import jakarta.annotation.PreDestroy;
import org.springframework.beans.factory.DisposableBean;
import org.springframework.beans.factory.InitializingBean;
public class LifecycleBean implements InitializingBean, DisposableBean {
public LifecycleBean() {
System.out.println("1 constructor");
}
@PostConstruct
void postConstruct() {
System.out.println("2 @PostConstruct");
}
@Override
public void afterPropertiesSet() {
System.out.println("3 afterPropertiesSet");
}
void customInit() {
System.out.println("4 custom init");
}
@PreDestroy
void preDestroy() {
System.out.println("5 @PreDestroy");
}
@Override
public void destroy() {
System.out.println("6 destroy");
}
void customDestroy() {
System.out.println("7 custom destroy");
}
}java
@Bean(initMethod = "customInit", destroyMethod = "customDestroy")
LifecycleBean lifecycleBean() {
return new LifecycleBean();
}在上述条件下,创建 Bean 时的预期输出是 1 constructor 到 4 custom init;正常关闭上下文时的预期输出是 5 @PreDestroy 到 7 custom destroy。编号表达回调顺序,不代表所有输出都发生在启动阶段。生产代码通常选择一种合适的初始化方式和清理方式,不必同时使用全部回调。
要观察目标对象与容器引用的差别,可以在启用自动代理的配置中注册一个匹配该 Bean 方法的切面或事务 Advisor。Advisor 是把匹配规则与增强行为组合起来的对象;只有实际匹配,才可能触发代理创建。
先观察初始化内部:将前面 LifecycleBean 中已有的 postConstruct() 替换为下面的方法,在原有顺序日志后打印目标类名。不要另加一个带 @PostConstruct 的方法;同一个类只应声明一个这样的生命周期注解方法。
java
@PostConstruct
void postConstruct() {
System.out.println("2 @PostConstruct");
System.out.println("inside init: " + getClass().getName());
}再观察容器提供的引用:下面的局部片段放在上下文完成启动后的调用代码中。context 表示应用上下文,AopUtils 需导入 org.springframework.aop.support.AopUtils。按具体类获取 Bean 还要求代理暴露的类型与 LifecycleBean 兼容;若使用只暴露接口的 JDK 动态代理,应按相应接口获取。
java
Object bean = context.getBean(LifecycleBean.class);
System.out.println("from context: " + bean.getClass().getName());
System.out.println("is proxy: " + AopUtils.isAopProxy(bean));在符合代理条件的常规流程中,预期初始化内部观察到目标类,而容器外部观察到代理,AopUtils.isAopProxy(bean) 返回 true。若没有匹配的增强,两处也可能都观察到原对象。类名只是辅助线索,不能通过一次输出推断所有代理场景;循环依赖中的早期代理还需单独分析。
4. 各阶段适合做什么
初始化的目标是让对象具备可用状态;启动的目标是让组件开始持续工作。两者分开,容器才有机会统一管理消费者、调度器等组件的启停。对象不变量指正常使用时必须满足的基本条件,例如必需依赖不能为 null。
初始化回调在 Bean 创建流程中执行。如果它等待外部系统却没有超时,当前 Bean 就无法完成创建,依赖它的其他 Bean 也无法继续准备;发生在启动阶段时,应用启动也会被阻塞。因此,初始化适合有明确完成边界的准备工作,持续运行的任务则应交给生命周期启动阶段管理。
| 阶段 | 适合 | 不适合 |
|---|---|---|
| 构造器 | 保存必需依赖、建立对象不变量 | 网络调用、启动线程、访问未注入字段 |
| 初始化回调 | 快速校验配置、构建本地派生状态 | 无界重试、长时间阻塞 |
| 生命周期启动 | 启动消费者、调度器等可管理组件 | 脱离容器管理的裸线程 |
| 销毁回调 | 释放连接、停止线程、刷新缓冲 | 假设进程一定能优雅退出 |
5. Aware 回调是什么
Aware 接口用于声明“这个对象需要知道某项容器信息”。BeanNameAware 提供当前 Bean 的名称,BeanFactoryAware 提供负责获取和创建 Bean 的工厂,ApplicationContextAware 提供应用上下文。容器调用相应方法,把这些信息传给 Bean。
它们不全由同一个入口调用:BeanNameAware、BeanFactoryAware 等基础回调在初始化前处理器链之前执行,ApplicationContextAware 则由该链中的处理器调用。因此,不能把所有 Aware 接口都当成一个不可再分的时间点。
Aware 适合框架和基础组件。普通业务代码优先声明所需协作对象,让容器直接注入;如果普遍持有容器并调用 getBean(),依赖关系就会隐藏在运行时查找中,增加理解和测试成本。
6. prototype 的销毁边界
Scope(作用域)决定实例的共享范围,也影响销毁责任。默认的 singleton(单例)在同一个容器中共享实例;prototype(原型)则在请求该 Bean 时创建新实例。
对于 prototype Bean,容器通常负责创建和初始化,但不会像单例一样自动完整追踪销毁。因此,不能指望关闭上下文自动清理每个 prototype 实例;持有者应负责释放连接、文件句柄等外部资源。
BeanDefinition 是描述对象如何创建的定义,不是对象本身。单例销毁通常依据容器记录的依赖关系,并由销毁适配器统一调用不同形式的清理方法,不能简单理解为按定义注册顺序倒着执行。若容器记录了 A 依赖 B,应先清理仍会使用 B 的 A,再清理 B。未正确登记的自定义依赖、手工创建的对象和进程强杀,都可能使这种预期无法成立。
销毁回调内部也不能假定外部资源始终可用:关闭阶段下游可能已经不可达,线程可能被中断,编排平台也可能只给出有限终止宽限期。清理逻辑应限制等待时间,并尽量做到重复调用也不会破坏状态。
7. 容易踩的坑
- 在
@PostConstruct中调用本类的事务方法:常规 Spring AOP 代理模式下,这是目标对象内部调用,不会经过最终代理,不能依靠该调用触发事务增强。 - 销毁方法没有执行:进程被强杀、上下文未关闭或对象不是容器 Bean。
- 初始化回调访问外部系统且没有超时,导致启动永久卡住。
- 在构造器中启动线程:新线程可能在字段注入或初始化完成前访问对象,读到尚未准备好的状态。
- 把业务启动顺序寄托在 BeanDefinition 注册顺序上:定义登记的先后不等于组件开始工作的先后,应按依赖关系或生命周期管理需求设计。
8. 排障方法
先区分是初始化回调缺失、销毁回调缺失,还是方法调用没有经过代理;三类问题的检查入口不同。
初始化方法没执行时:
- 对象是否由 Spring 创建并完成初始化,而不是仅由业务代码直接
new出来? - 对应注解处理器是否已注册,是否使用 Spring 6 对应的
jakarta.annotation,而非旧的javax.annotation? - 构造器、依赖注入或更早的处理器是否已经失败,导致流程没有到达初始化回调?
- 日志观察的实例是否就是预期 Bean,是否存在另一个同类型 Bean?
销毁方法没执行时:
- 上下文是否真正执行了
close(),还是进程被强杀、关闭流程没有完成? - 对象是否属于容器管理的 Bean?
- 它是 singleton、prototype 还是自定义 Scope,该作用域是否负责管理销毁?
初始化期间事务等增强没生效时:
- 调用是否发生在目标对象内部,绕过了代理?
- 容器最终提供的对象是否经过初始化后处理并成为代理,还是根本没有匹配的增强?
- 是否涉及循环依赖和早期代理,不能直接套用普通创建时间线?
9. 总结
Bean 生命周期是一条有顺序的加工链,扩展逻辑只有放在正确阶段,行为才可预测。
- 构造器只建立对象基本状态,不应承担外部资源启动。
- 初始化完成不等于最终对象不会再被代理包装。
- 销毁回调是资源清理机会,但不能替代超时、租约等进程外保护。
阅读导航
- 对象创建主线:03 - getBean() 背后的单例 Bean 创建链路
- 注入发生在哪一阶段:04 - Spring 如何完成依赖注入
- 回调由哪些处理器实现:06 - BeanPostProcessor
- 容器级扩展怎么选:18 - Spring 扩展点选型与执行顺序
- 创建期早期代理:07 - 三级缓存与循环依赖
- 关闭失败与线程泄漏:并发 27 - 并发任务泄漏与进程无法退出
- 容器启动后注册的周期任务:29 - Spring 定时任务