外观
06 - BeanPostProcessor:Spring 的实例加工流水线
适用版本:Spring Framework 6.x。
前置阅读:05 - Bean 生命周期与扩展点顺序。本文解释生命周期时间线上的处理器由谁实现、怎样注册以及提前实例化为何危险。
摘要
Spring 创建 Bean,不只是调用构造器。对象还要接收依赖、执行初始化回调,并可能被包装成代理。BeanPostProcessor(Bean 后处理器)及其扩展接口,让框架在这些阶段参与加工。理解这条处理链,就能解释注解处理和代理创建发生在哪里,以及为什么提前创建 Bean 可能使它错过某些处理器。
1. 场景:同一个类为什么有时是代理,有时是原对象
假设一个服务已经配置了事务增强:正常注入时,调用会经过事务代理;在自定义容器扩展中提前获取它时,却拿到了原对象。代理是调用方持有的外层对象,负责在转发业务方法调用时加入事务等行为。直接调用原对象,就可能绕过这些行为。
一种需要排查的原因是:服务创建时,负责代理的后处理器还没有注册。容器只能调用当时已经注册的处理器。因此,要同时检查“Bean 何时创建”和“处理器何时注册”,不能只看服务上有没有事务注解。
2. 基础接口
先区分两个阶段:实例化是准备构造参数并创建对象;初始化是在依赖注入后执行初始化回调,让对象具备可用状态。基础接口提供的是初始化前、初始化后的两个入口,不等于覆盖对象创建的每一步。
下面是接口的简化片段,用于说明返回值如何参与处理链:
java
public interface BeanPostProcessor {
default Object postProcessBeforeInitialization(Object bean, String beanName) {
return bean;
}
default Object postProcessAfterInitialization(Object bean, String beanName) {
return bean;
}
}每个阶段都可以有多个处理器。容器依次调用它们,把上一个处理器返回的对象交给下一个。返回传入对象表示继续使用当前对象;返回包装对象或代理,则会改变后续处理器接收到的引用。常规创建流程结束后,容器对外提供加工后的最终引用。
postProcessBeforeInitialization() 位于初始化回调之前的处理链中,postProcessAfterInitialization() 位于初始化回调之后。@PostConstruct 是声明初始化方法的注解,由初始化前处理链中的注解处理器调用,所以自定义“初始化前”处理器不一定早于 @PostConstruct:还要看它在链中的位置。
若某个处理器返回 null,Spring 当前常规实现会停止该阶段剩余处理器的调用,并保留此前结果;它不是“容器最终必然返回 null”。但这仍会截断后续处理器,因此自定义实现通常应返回传入 Bean,除非明确理解并测试短路语义。
3. 常见扩展层次
依赖注入需要介入初始化之前,循环依赖还可能需要在对象尚未初始化完成时提供引用,因此仅有基础接口的两个方法不够。扩展接口提供了更早或更具体的入口。BeanDefinition 是描述 Bean 如何创建的定义;元数据是注入位置、生命周期方法等供框架使用的描述信息。
BeanPostProcessor:初始化前后加工对象;InstantiationAwareBeanPostProcessor:参与实例化前后和属性填充;SmartInstantiationAwareBeanPostProcessor:预测类型、选择构造器、提供早期引用;MergedBeanDefinitionPostProcessor:处理合并后的 BeanDefinition 元数据。
这些接口主要服务框架基础设施。业务需求若只需观察事件或执行启动任务,不应优先选择最底层后处理器。
阅读源码时,可以围绕 doCreateBean() 理解常规实例创建主线,再向外查看实例化前的入口。下表按职责归类,不是所有 Bean 都必经的严格执行顺序;实例化前返回替代对象属于主线之外的分支,早期引用则按需产生。
| 创建阶段 | 常见扩展接口 | 能影响什么 |
|---|---|---|
| 实例化前 | InstantiationAwareBeanPostProcessor | 直接返回替代对象,跳过常规实例化 |
| 构造器选择 | SmartInstantiationAwareBeanPostProcessor | 提供候选构造器、预测类型 |
| 合并定义处理 | MergedBeanDefinitionPostProcessor | 根据合并后的定义缓存注入点、生命周期注解等元数据 |
| 属性填充 | InstantiationAwareBeanPostProcessor | 参与字段、方法和属性注入 |
| 初始化前 | BeanPostProcessor | 在基础 Aware 回调之后加工;部分 Aware 和生命周期注解回调也由此阶段的处理器执行 |
| 初始化后 | BeanPostProcessor | 返回最终对象或代理 |
| 提前引用 | SmartInstantiationAwareBeanPostProcessor | 循环依赖时协调早期代理 |
Aware 接口用于让 Bean 接收名称、容器等信息,具体回调位置见前置生命周期文章。早期引用是对象尚未完成初始化时供依赖方持有的引用,不代表对象已经可以安全执行业务。依赖注入、生命周期注解和代理创建各有入口,不能把后处理器体系理解成一组只在 @PostConstruct 前后运行的回调。
4. AOP 与后处理器
AOP(面向切面编程)把事务、日志等行为与业务方法实现分开。Spring AOP 的自动代理创建器属于后处理器体系,在常规流程中于初始化后判断是否存在匹配的 Advisor,并在需要时返回代理。Advisor 将“哪些调用需要处理”的匹配规则与“加入什么行为”的增强逻辑组合起来。没有匹配的增强时,Bean 可以继续以原对象形式对外提供。
下图只展示职责衔接,不表示这些处理器始终按固定顺序各执行一次。循环依赖中的早期代理还会走提前引用分支。
图表将在阅读到此处时加载…
PriorityOrdered 和 Ordered 是表达处理器优先级的接口。处理器真实顺序受这些接口和注册顺序影响,不能只靠类名猜测。
自动发现的 BeanPostProcessor 会经过排序并统一注册;通过 BeanFactory API 程序化添加的处理器遵循注册顺序,并不自动套用同一排序过程。依赖精确顺序时,应检查处理器是怎样进入 BeanFactory 的,而不只是查看其 @Order。
5. 一个安全的观察型处理器
下面的类只记录名称以 order 开头的 Bean。它需要 Spring Framework 6.x 的相关依赖,并注册到容器的后处理器链中才会生效;代码只包含处理器类,不包含配置类和上下文启动入口。
java
import org.springframework.beans.factory.config.BeanPostProcessor;
public class TimingBeanPostProcessor implements BeanPostProcessor {
@Override
public Object postProcessAfterInitialization(Object bean, String beanName) {
if (beanName.startsWith("order")) {
System.out.printf("initialized %s as %s%n",
beanName, bean.getClass().getName());
}
return bean;
}
}在该处理器被调用、且 Bean 名以 order 开头的条件下,预期输出格式是 initialized <Bean名> as <运行时类名>。它打印的是到达当前处理器时的对象类型:若代理创建器排在后面,这里看到的仍可能是原始类。类名中的 Timing 不代表代码测量了耗时。
它返回传入对象,因此不会主动改变后续处理链使用的引用,风险较低。若要替换对象,必须保证调用方所需的类型、行为和生命周期兼容。
观察型处理器也应避免对所有 Bean 无条件执行昂贵反射。可以先按包名、Bean 名或目标类型快速排除,再缓存元数据结果。测量启动开销时,应把处理器扫描时间与 Bean 自身初始化时间分开。
6. 为什么处理器本身要谨慎依赖其他 Bean
为了让普通业务 Bean 经过完整处理链,上下文需要先发现、创建并注册 BeanPostProcessor,再创建普通业务 Bean。但处理器本身也是对象,创建它时同样需要解析依赖。若它直接依赖一个业务 Bean,容器就可能在注册过程尚未完成时先创建该业务 Bean。
下面是构造器依赖的反例片段,需导入 BeanPostProcessor、提供 OrderService 定义,并将处理器注册为 Bean:
java
class AuditPostProcessor implements BeanPostProcessor {
AuditPostProcessor(OrderService orderService) { }
}容器必须先取得 OrderService,才能调用这个构造器;而此时负责事务等能力的处理器可能还未注册。对于已提前创建并缓存的单例,后续注册处理器不会自动重放完整创建流程。稍后再次获取该单例,也不能据此期待它补上缺失的代理。
更稳妥的方式是让处理器依赖轻量基础设施,或通过 ObjectProvider 延迟获取。ObjectProvider 是按需获取依赖的入口:注入这个入口与立即取得目标 Bean 是两件事。若在处理器构造器或注册阶段立刻获取业务 Bean,仍会触发提前创建,不能达到延迟目的。
7. 容易踩的坑
- 对所有 Bean 无条件做昂贵反射扫描:开销随处理范围累积,可能拖慢启动,应测量后再判断影响。
- 忘记返回 Bean,破坏后续处理链。
- 重复包装已经代理的对象,造成多层代理和重复执行。
- 在处理器里调用目标 Bean 的业务方法,引发递归创建或半初始化访问。
- 用低层扩展实现普通业务逻辑,导致代码依赖 Spring 内部时序。
8. 排障清单
先确认是否缺少代理,再沿创建时序定位处理器为什么没有生效。类型和代理标记只是线索,还应核对增强是否匹配、调用是否经过代理。AopUtils 是 Spring 的 AOP 工具类,完整类名为 org.springframework.aop.support.AopUtils。
- 实际注入对象的
getClass()是什么? AopUtils.isAopProxy(bean)是否为真?- 日志中是否提示某 Bean“不适合被所有 BeanPostProcessor 处理”?
- 是否有 BeanFactory 后处理器或 BeanPostProcessor 提前调用
getBean()? - 自定义处理器是否声明了正确顺序?
- 处理器是自动发现还是通过 API 程序化注册?
- 哪一个处理器首次把原始对象替换成了代理或包装对象?
- 是否因为返回
null让同阶段后续处理器被短路?
9. 总结
BeanPostProcessor 是 Spring 对 Bean 实例进行统一加工的流水线,也是许多声明式能力的共同基础。
- 后处理器操作的是实例,BeanFactory 后处理器主要操作定义。
- AOP 代理通常是初始化后处理的结果,因此最终 Bean 可能不是原始对象。
- 基础设施过早获取业务 Bean,会让对象错过完整处理链。
阅读导航
- 生命周期中的位置:05 - Bean 生命周期与扩展点顺序
- 注入处理器的职责:04 - Spring 如何完成依赖注入
- 早期引用与代理一致性:07 - 三级缓存与循环依赖
- 自动代理创建器:09 - Spring AOP 如何创建代理
- 定义级与实例级扩展选型:18 - Spring 扩展点选型与执行顺序
- 全局处理器拖慢启动:19 - Spring 启动慢与 Bean 创建慢排查
- 实例加工在原生镜像中的边界:26 - Spring AOT 与 Native Image