外观
09 - Spring AOP 如何创建代理:JDK Proxy、CGLIB 与 Advisor 链
适用版本:Spring Framework 6.x。Spring AOP 是基于代理的运行时方法拦截,不等同于完整 AspectJ 编织。
前置阅读:06 - BeanPostProcessor。若涉及循环依赖中的早期代理,先阅读 07 - 三级缓存与循环依赖。
摘要
注入接口后强转实现类失败、final 方法没有增强、一次调用经过多个拦截器——这些现象都与代理创建有关。本文沿自动代理创建器解释 Advisor 如何匹配 Bean,Spring 如何选择 JDK Dynamic Proxy 或 CGLIB,以及如何在线上确认真实代理类型。
1. 场景:注入对象为什么不能强转实现类
java
PaymentService service = context.getBean(PaymentService.class);
PaymentServiceImpl impl = (PaymentServiceImpl) service; // 可能抛 ClassCastException这里假设 PaymentService 是业务接口,PaymentServiceImpl 是其实现类,context 是已启动且注册了该服务的 Spring 应用上下文。代码是局部调用片段。
Spring AOP(面向切面编程)把日志、事务等公共逻辑放在业务调用的外围。调用方取得的对象可能是 Proxy(代理对象):它先处理增强逻辑,再把调用转交给 Target(目标对象),也就是执行实际业务方法的对象。代理与目标承担不同职责,类型也未必相同。
如果使用 JDK Dynamic Proxy(JDK 动态代理),代理实现 PaymentService 接口,但不是 PaymentServiceImpl 的子类。因此按接口获取对象可以成功,强转实现类却会抛出 ClassCastException。调用方应依赖服务接口,而不是假定容器返回的一定是实现类实例。
2. AOP 核心术语
有了“调用方 → 代理 → 目标对象”的模型,再看代理如何决定在哪些调用上执行增强:
- Advice(通知或增强逻辑):在目标方法执行前、返回后或抛出异常时执行的逻辑,也可以环绕整个调用。
- Pointcut(切点):判断哪些类和方法需要增强的匹配规则;部分规则还需要检查本次调用的参数。
- Advisor(增强器):把增强逻辑与适用范围关联起来。本文主要讨论组合
Pointcut与Advice的切点型 Advisor。 - Interceptor(方法拦截器):调用链中实际处理方法调用的组件。Spring 会把适用的 Advice 适配为拦截器。
自动代理创建器是一类 BeanPostProcessor(Bean 后处理器),负责在 Bean 创建过程中判断是否需要包装代理。常规路径是在初始化完成后寻找适用的 Advisor:没有匹配项就返回原对象,有匹配项则配置 Advisor 并创建代理。循环依赖涉及的早期代理路径见前置阅读,不能把它直接等同于初始化后的包装路径。
图表将在阅读到此处时加载…
典型自动代理创建器继承自 AbstractAutoProxyCreator。阅读源码时要分开看创建阶段和调用阶段:前者决定 Bean 是否需要代理以及代理携带哪些 Advisor,后者决定当前方法经过哪些拦截器。下面是主线示意,不是完整源码调用栈:
text
创建阶段:postProcessAfterInitialization
→ wrapIfNecessary
→ 找到适用 Advisor
→ createProxy
调用阶段:代理方法入口
→ 为当前方法取得拦截器链
→ MethodInvocation.proceed()
→ 逐个拦截器执行
→ 目标方法创建时,只要类中有方法适用某个 Advisor,就可能需要为整个 Bean 创建代理。这不意味着该 Bean 的每个方法都要增强。调用时还要针对具体方法取得拦截器链;若切点依赖运行时参数,还需在调用过程中继续判断。因此,“Bean 是代理”与“这次方法调用被增强”是两个不同结论。
3. 两种代理方式
JDK Dynamic Proxy
JDK 根据接口生成代理类,代理对象通过统一的调用处理入口接收接口方法调用。它由 JDK 原生支持,调用能力以代理暴露的接口为边界;实现类独有的方法不能通过这个接口代理直接调用。第 1 节的强转失败正是这种类型关系的结果。
CGLIB
CGLIB 通过生成目标类的子类实现代理,依靠覆盖方法接收调用。这个机制也决定了限制:final 类不能被继承,final 方法不能被覆盖,private 方法对子类不可见,因此都不能通过这种子类覆盖机制增强。包可见方法还受包和类加载器边界影响。
Spring Framework 6 内部包含相应字节码生成支持,实际选择还受配置、是否存在用户接口及框架策略影响。
Spring Framework 通过 @EnableAspectJAutoProxy 等机制启用代理时,proxyTargetClass 默认不是强制类代理;Spring Boot 的 AOP 自动配置通常默认使用类代理,可通过 spring.aop.proxy-target-class 调整。项目可能继续被其他基础设施改变代理策略,因此最终仍应检查运行对象,不能只凭框架默认值判断。
代理具备拦截能力只是一个前提。事务、异步等声明式功能还可能对方法可见性增加限制,各自支持范围并不完全相同,应结合具体 Advisor 和 Spring 小版本验证。
4. 调用时发生什么
调用进入代理后,Spring 为当前方法取得匹配的拦截器链。MethodInvocation 表示一次方法调用,包含方法、参数和目标等信息;它的 proceed() 用于推进调用链。拦截器调用 proceed() 后,执行下一个拦截器;链走到末尾才调用目标方法。环绕增强也可以直接返回或抛出异常,从而不再继续调用。
下图展示调用确实到达目标方法时的常规路径。目标返回或抛出异常后,控制权沿链向外返回;各 Advice 是否处理返回值或异常,取决于其类型和实现。
图表将在阅读到此处时加载…
多个 Advice 形成嵌套调用。先进入的环绕拦截器位于外层,后进入的位于内层,返回时顺序相反。这个顺序会影响事务、重试和缓存语义,应通过 @Order 注解、Ordered 接口或对应框架规则明确控制,并用集成测试验证。
5. 最小示例:确认代理类型
以下是诊断片段,需要在包含 spring-aop 依赖的 Spring Framework 6.x 项目中使用。context 和 PaymentService 沿用第 1 节的前提;要观察 AOP 代理,还需要启用相应 AOP 基础设施,并注册能匹配该服务的 Advisor。
java
import org.springframework.aop.support.AopUtils;
Object bean = context.getBean(PaymentService.class);
System.out.println(bean.getClass().getName());
System.out.println("is proxy: " + AopUtils.isAopProxy(bean));
System.out.println("jdk: " + AopUtils.isJdkDynamicProxy(bean));
System.out.println("cglib: " + AopUtils.isCglibProxy(bean));预期结果随实际配置变化:Spring AOP 的 JDK 代理对应 is proxy: true、jdk: true、cglib: false;CGLIB 代理对应 true、false、true;没有 AOP 包装的普通对象对应三个 false。具体代理类名随环境变化,不应作为固定断言。
AopUtils 判断的是 Spring AOP 代理,不能用它识别所有第三方动态代理。诊断时优先使用这些类型判断方法,再检查代理实际携带的 Advisor。
在受控环境中可进一步打印 Advisor:
java
if (bean instanceof org.springframework.aop.framework.Advised advised) {
for (var advisor : advised.getAdvisors()) {
System.out.println(advisor);
}
}该片段只有在对象实现 Advised 接口时才打印内容。Advised 是 Spring AOP 暴露代理配置信息的接口,可以查询代理携带的 Advisor。列表说明了代理配置,却不能单独证明某个方法的切点一定匹配;还要记录具体方法(Method)、目标类和拦截器是否实际进入。
5.1 用计数器验证拦截器链,而不是只看类名
切面(Aspect)把切点与相关 Advice 组织在一起。测试时可以在 Advice 中递增计数器:每个用例开始前先清零,通过容器返回的代理外部调用一次匹配方法,断言计数为 1;另一个用例调用不匹配方法,断言计数仍为 0。这里以一次调用只进入该 Advice 一次、没有重试或并发调用为前提。
若存在多个切面,再记录进入和退出序列。下面是重试位于外层、事务位于内层,且目标正常返回、没有触发重试时的预期日志顺序;这些标签需要由测试拦截器自行记录:
text
retry.before
transaction.before
target
transaction.after
retry.after事务位于重试内部时,每次重试都会重新经过事务拦截器;重试位于事务内部时,多次尝试被同一次外层事务拦截调用包围。实际创建或加入多少个事务,还取决于传播行为和已有事务;失败结果也受回滚规则影响。因此,测试既要断言嵌套顺序,也要验证提交、回滚和重试结果。
6. 反例与正例
反例:把按接口获取的对象强转实现类,使调用方依赖代理策略。
java
PaymentServiceImpl service =
(PaymentServiceImpl) context.getBean(PaymentService.class);正例:按稳定的业务接口获取和使用服务。
java
PaymentService service = context.getBean(PaymentService.class);若确实需要实现类特有能力,应先重新审视接口边界,而不是强制更换代理模式来迁就调用方。
7. 容易踩的坑
final、private 或不可覆盖方法无法通过子类代理按预期增强。- 业务代码直接
new对象并使用,没有经过容器的自动代理加工路径。 - 切点表达式过宽,代理大量无关 Bean,增加启动与调用成本。
- 多个切面顺序未明确,无法判断重试与事务的嵌套关系。
- 只检查目标类注解,忽略注解位于接口时不同代理策略的解析差异。
8. 排障清单
- 当前对象是否由 Spring 容器管理?
- 实际对象是原类、JDK Proxy 还是 CGLIB Proxy?
- 方法是否能被代理覆盖或通过接口调用?
- Pointcut 是否真的匹配目标方法?
- Advisor 是否已注册,顺序是否正确?
- 调用是否经过代理对象?
- 代理上实际有哪些 Advisor,目标方法匹配了哪些拦截器?
- 当前代理策略来自 Framework 配置、Boot 属性还是其他基础设施?
- 多个 Advice 的进入与退出顺序是否符合事务、缓存和重试语义?
9. 总结
Spring AOP 的关键不是“有注解”,而是容器创建了代理,并且调用真正经过了匹配的拦截器链。
- Advisor 决定增强逻辑及其匹配范围。
- JDK Proxy 面向接口,CGLIB 基于子类,各自有类型和方法限制。
- 排查 AOP 时先确认实际对象和调用路径,再检查注解。
阅读导航
- 自动代理创建器所在阶段:06 - BeanPostProcessor
- 早期代理身份:07 - 三级缓存与循环依赖
- 调用为什么绕过代理:10 - 同类调用为什么绕过 AOP
- 事务 Advisor 的执行链:11 - Spring 声明式事务执行链
- 多个 Advisor 如何嵌套:24 - Spring 切面顺序与组合语义
- 字节码与动态调用基础:JVM 09 - 类文件结构与字节码