Spring Bean 的生命周期:从实例化到销毁的完整回调顺序
为什么回调顺序值得较真
日常开发里,Bean 的创建常被简化成"加一个 @Component 就能用"。但一旦涉及缓存预热、连接初始化、动态代理和优雅下线,回调顺序就会直接影响正确性:在构造器里调用本类的 @Transactional 方法拿不到事务,在 @PostConstruct 里发远程请求导致启动变慢甚至失败,@PreDestroy 里关闭线程池的顺序不对导致任务丢失。这些问题往往不是 API 用错,而是对生命周期阶段的理解错位。
本文以 AnnotationConfigApplicationContext 的启动流程为主线,把单例 Bean 的创建与销毁拆成可验证的步骤,并说明每个阶段可以做什么、不能做什么。
主流程:从 BeanDefinition 到可用对象
Spring 启动时先读取配置得到 BeanDefinition,之后由 DefaultListableBeanFactory#getBean 触发创建,真正执行创建的是 AbstractAutowireCapableBeanFactory#doCreateBean,它分为四段:
createBeanInstance:选择构造器、工厂方法或Supplier完成实例化。此时对象已经存在,但字段都是默认值。populateBean:按类型或名称注入依赖,处理@Autowired、@Value以及 BeanDefinition 中声明的属性值。initializeBean:执行 Aware 回调、BeanPostProcessor前置处理、初始化方法、BeanPostProcessor后置处理。registerDisposableBeanIfNecessary:为单例注册销毁回调。
依赖注入发生在 populateBean:先按类型匹配,候选多个时再结合 @Qualifier、@Primary、@Priority 和字段名决定;找不到或出现歧义会抛 UnsatisfiedDependencyException,因此在启动阶段就能暴露配置问题。Spring 4.3 之后,单构造器可以省略 @Autowired;存在多个构造器时必须显式标注,否则容器会尝试无参构造器,缺依赖时同样在启动期失败。
initializeBean 内部的顺序是固定的:
invokeAwareMethods:回调BeanNameAware、BeanClassLoaderAware、BeanFactoryAware;applyBeanPostProcessorsBeforeInitialization:ApplicationContextAwareProcessor在这里回调EnvironmentAware、ApplicationContextAware等接口;@PostConstruct由CommonAnnotationBeanPostProcessor在这一步调用;invokeInitMethods:先调用InitializingBean#afterPropertiesSet,再反射调用init-method;applyBeanPostProcessorsAfterInitialization:AOP 代理通常在这里由AbstractAutoProxyCreator创建。
因此同一个 Bean 上,Aware 回调早于 @PostConstruct,@PostConstruct 早于 afterPropertiesSet,init-method 最后执行。销毁阶段与之对称:DestructionAwareBeanPostProcessor#postProcessBeforeDestruction(@PreDestroy 在此触发)→ DisposableBean#destroy → destroy-method。
创建过程中还有两个容易被忽略的细节。其一,单例的提前引用通过三级缓存解决:getSingleton 先查一级缓存 singletonObjects,再查 earlySingletonObjects,最后查 singletonFactories 并调用 ObjectFactory 提前暴露对象。因此构造器注入形成的循环依赖无法解决,而 setter 或字段注入可以。其二,@Bean 工厂方法与构造器实例化都在 createBeanInstance 阶段处理,但工厂方法所在的配置类必须先实例化,这也是把 BPP 声明为 static 的原因之一。
所有单例实例化完成后,preInstantiateSingletons 还会回调 SmartInitializingSingleton#afterSingletonsInstantiated。它晚于任何 Bean 的初始化,适合做依赖全局视图的收尾工作,但仍处于容器刷新过程中,早于 ApplicationRunner。
InstantiationAwareBeanPostProcessor:能改写主流程的扩展点
普通 BeanPostProcessor 只能插手初始化前后,而 InstantiationAwareBeanPostProcessor 还能插手实例化本身:
postProcessBeforeInstantiation:在构造器调用前执行,若返回非 null,Spring 直接把它当作最终 Bean,跳过后续实例化和属性填充;postProcessAfterInstantiation:返回false可以跳过属性填充;postProcessProperties:完成@Autowired注入,由AutowiredAnnotationBeanPostProcessor实现。
理解这一点,才能解释"构造器没有执行,但容器里已经有这个 Bean"的现象,也能理解为什么自定义 BPP 的顺序会影响到注入结果。
多个 BPP 之间通过 PriorityOrdered、Ordered 或 @Order 排序,实现 PriorityOrdered 的排在最前。若自定义 BPP 依赖某个业务 Bean,不要在 BPP 中直接注入它,而应延迟到 postProcessAfterInitialization 时按名称查找;否则该 Bean 会被提前创建,跳过其余 BPP 的处理。
代码:一次启动打印完整顺序
下面是一个最小可运行示例,覆盖构造器、Aware、BPP、三种初始化方式和三种销毁方式。
import jakarta.annotation.PostConstruct;
import jakarta.annotation.PreDestroy;
import org.springframework.beans.BeansException;
import org.springframework.beans.factory.*;
import org.springframework.context.annotation.*;
public class DemoBean implements BeanNameAware, BeanFactoryAware,
InitializingBean, DisposableBean {
public DemoBean() { System.out.println("1 构造器"); }
@Override
public void setBeanName(String name) { System.out.println("2 BeanNameAware"); }
@Override
public void setBeanFactory(BeanFactory beanFactory) throws BeansException {
System.out.println("3 BeanFactoryAware");
}
@PostConstruct
public void postConstruct() { System.out.println("5 @PostConstruct"); }
@Override
public void afterPropertiesSet() { System.out.println("6 afterPropertiesSet"); }
public void customInit() { System.out.println("7 init-method"); }
@PreDestroy
public void preDestroy() { System.out.println("9 @PreDestroy"); }
@Override
public void destroy() { System.out.println("10 DisposableBean.destroy"); }
public void customDestroy() { System.out.println("11 destroy-method"); }
}
@Configuration
public class LifecycleConfig {
@Bean(initMethod = "customInit", destroyMethod = "customDestroy")
public DemoBean demoBean() {
return new DemoBean();
}
// 必须是 static,避免配置类被提前实例化
@Bean
public static BeanPostProcessor lifecycleLoggingPostProcessor() {
return new BeanPostProcessor() {
@Override
public Object postProcessBeforeInitialization(Object bean, String beanName) {
if (bean instanceof DemoBean) {
System.out.println("4 postProcessBeforeInitialization");
}
return bean;
}
@Override
public Object postProcessAfterInitialization(Object bean, String beanName) {
if (bean instanceof DemoBean) {
System.out.println("8 postProcessAfterInitialization");
}
return bean;
}
};
}
}
public class LifecycleDemo {
public static void main(String[] args) {
AnnotationConfigApplicationContext ctx =
new AnnotationConfigApplicationContext(LifecycleConfig.class);
ctx.getBean(DemoBean.class);
ctx.close();
}
}
运行输出依次为 1 到 11,这套顺序在 Spring 5 与 Spring 6 上基本一致,可以作为排查时的基线。需要注意,ApplicationContextAware 并不在第 3 步,它由 ApplicationContextAwareProcessor 在第 4 步前后回调;BeanFactoryAware 才是 invokeAwareMethods 直接处理。两者常被混为一谈。另外,@PostConstruct 由 CommonAnnotationBeanPostProcessor 执行,如果容器中没有注册该处理器(例如手动构造精简的 BeanFactory),注解不会生效,此时应实现 InitializingBean。
销毁只对单例生效。容器关闭时先发布 ContextClosedEvent,再按依赖逆序销毁单例,最后关闭 BeanFactory。实现 SmartLifecycle 的 Bean 会在停止阶段先收到 stop 回调,适合停止消费者、等待在途请求,比 @PreDestroy 更可控。
示例使用 jakarta.annotation 包,Spring Boot 3 已自带;Spring 5 或 Java EE 环境对应的是 javax.annotation。此外,Aware 回调参数是容器内部对象,不要把 BeanFactory 保存到静态字段做服务定位,否则容易造成生命周期错乱和类加载器泄漏。
实践建议与踩坑
- 不要在构造器和
@PostConstruct中调用本类的@Transactional、@Async或@Cacheable方法。此时 Bean 还是原始对象,AOP 代理要到postProcessAfterInitialization才生成,调用必然绕过增强。需要事务时,应通过代理从外部调用,或改用TransactionTemplate。 @Bean形式的BeanPostProcessor要声明为static。否则为了创建 BPP 必须先实例化所在配置类,配置类中的其他 Bean 会被提前创建,导致后面的 BPP 来不及生效,日志中通常伴随 "is not eligible for getting processed by all BeanPostProcessors"。- 原型 Bean 不执行销毁回调。容器只负责创建,不跟踪销毁;需要清理就自行调用,或把资源交给单例管理。
- 销毁顺序默认与依赖顺序相反,但不要依赖创建顺序来保证销毁顺序。有明确依赖就写
@DependsOn,需要分阶段停机就实现SmartLifecycle。 @Bean方法返回AutoCloseable时,Spring 会自动推断close或shutdown作为销毁方法。不希望自动调用时,写@Bean(destroyMethod = "")。- 启动期不要做耗时远程调用。初始化失败会让整个上下文启动失败;需要预热时用
ApplicationRunner或SmartLifecycle,并设置超时和降级。 - 需要保证 Bean 在容器完全启动后才对外提供服务时,不要只依赖
@PostConstruct。注册中心注册、消息消费者启动应放到SmartLifecycle#start或ApplicationReadyEvent中,避免流量在初始化尚未完成时打进来。 InitializingBean、@PostConstruct、init-method可以同时存在,执行顺序固定,但通常没有必要叠加。选一种并保持团队一致即可,重复初始化容易埋下幂等性问题。
- 点赞
- 收藏
- 关注作者
评论(0)