Spring Bean 的生命周期:从实例化到销毁的完整回调顺序

举报
yd_254127822 发表于 2026/11/19 07:32:40 2026/11/19
【摘要】 以 BeanFactory 的创建与销毁流程为主线,逐段说明实例化、属性填充、Aware 回调、BeanPostProcessor、初始化方法与销毁方法的真实执行顺序,并给出可运行的验证代码与常见陷阱。

为什么回调顺序值得较真

日常开发里,Bean 的创建常被简化成"加一个 @Component 就能用"。但一旦涉及缓存预热、连接初始化、动态代理和优雅下线,回调顺序就会直接影响正确性:在构造器里调用本类的 @Transactional 方法拿不到事务,在 @PostConstruct 里发远程请求导致启动变慢甚至失败,@PreDestroy 里关闭线程池的顺序不对导致任务丢失。这些问题往往不是 API 用错,而是对生命周期阶段的理解错位。

本文以 AnnotationConfigApplicationContext 的启动流程为主线,把单例 Bean 的创建与销毁拆成可验证的步骤,并说明每个阶段可以做什么、不能做什么。

主流程:从 BeanDefinition 到可用对象

Spring 启动时先读取配置得到 BeanDefinition,之后由 DefaultListableBeanFactory#getBean 触发创建,真正执行创建的是 AbstractAutowireCapableBeanFactory#doCreateBean,它分为四段:

  1. createBeanInstance:选择构造器、工厂方法或 Supplier 完成实例化。此时对象已经存在,但字段都是默认值。
  2. populateBean:按类型或名称注入依赖,处理 @Autowired、@Value 以及 BeanDefinition 中声明的属性值。
  3. initializeBean:执行 Aware 回调、BeanPostProcessor 前置处理、初始化方法、BeanPostProcessor 后置处理。
  4. 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 可以同时存在,执行顺序固定,但通常没有必要叠加。选一种并保持团队一致即可,重复初始化容易埋下幂等性问题。
【声明】本内容来自华为云开发者社区博主,不代表华为云及华为云开发者社区的观点和立场。转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息,否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@huaweicloud.com
  • 点赞
  • 收藏
  • 关注作者

评论(0)

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。