1 / 4概念
AOP
AOP 要解决的从来不是「怎么少写代码」,而是「横切逻辑放在哪一层才不会被业务代码绕开」。Spring AOP 与 AspectJ 的差别,本质上是代理边界与字节码边界的差别。
1 概念
1.1 一句话定义
面向切面编程把日志、事务、鉴权、缓存这类横切关注点从业务方法里抽出来,用切点(pointcut)匹配连接点(join point),用通知(advice)在方法执行前后插入行为;Spring AOP 在运行期生成代理,AspectJ 在编译期或加载期把通知织入字节码。
1.2 它解决什么问题
- 集中声明:事务、缓存、安全规则写在一处,不用在每个业务方法里重复注解与判断。
- 业务纯净:服务类只表达业务意图,基础设施逻辑由切面承担。
- 切点复用:一个切点表达式可以覆盖一批方法,命名切点还能跨切面复用。
- 不改源码:AspectJ 织入能在不修改目标类的前提下拦截字段、构造器与静态方法。
代价是行为变得隐式:读代码看不到拦截,调试时调用栈多出一层,失效时往往没有任何报错。
1.3 不属于本页的内容
| 主题 | 去哪 |
|---|---|
| 事务传播、隔离级别与回滚规则 | Spring Boot |
| 代理生成的字节码与反射开销 | JVM Runtime |
| 异常包装与回滚的语义 | Error |
| 装饰器、组合与继承的取舍 | OOP |
| 编译期织入的构建集成 | Toolchain |
1.4 关键术语
| 术语 | 含义 | 容易混淆的点 |
|---|---|---|
| 切面 | 横切关注点的模块化单元 | 切面不是注解,注解只是标记 |
| 连接点 | 程序执行中可以插入行为的点 | Spring AOP 只支持方法执行 |
| 切点 | 匹配连接点的表达式 | 切点描述「哪里」,不描述「做什么」 |
| 通知 | 在连接点执行的动作 | 通知类型决定执行时机 |
| 织入 | 把切面并入目标的过程 | 代理是运行期织入的一种 |
| 目标对象 | 被代理或被织入的原始对象 | 代理对象不是目标对象 |
| 自调用 | 同类内部方法互相调用 | 不经过代理,通知全部失效 |
| 切点指示符 | execution、@annotation 等匹配原语 | bean() 是 Spring 专有扩展 |
2 机制
2.1 心智模型
调用方拿到的不是目标对象,而是代理。 代理先跑通知链,再决定是否把调用转给目标;只有经过代理的调用才会被拦截。AspectJ 换掉了这一层:通知被直接编进方法的字节码,所以不存在「绕过代理」这回事。
2.2 机制拆解
- 代理创建:Spring 在 Bean 初始化后由
BeanPostProcessor判断是否需要代理,需要则生成 JDK 动态代理(基于接口)或 CGLIB 子类(基于继承)。 - 代理选择:Spring Boot 2.x 起默认
proxyTargetClass=true,即优先 CGLIB;final类与final方法无法被代理。 - 切点匹配:
execution匹配方法签名,@annotation匹配方法注解,within匹配类型,args匹配运行时参数,bean()按 Bean 名匹配。 - 通知执行:
@Before在目标前,@AfterReturning在正常返回后,@AfterThrowing在抛异常后,@After等价于finally,@Around包围整个调用。 - 顺序:
@Order或Ordered数值越小越先执行,环绕通知的「进入」按顺序、「退出」按逆序;事务 advisor 默认LOWEST_PRECEDENCE。 - 失效条件:自调用、
private/static/final方法、非 Spring 管理的对象、JDK 代理下的非接口方法,都会让通知静默跳过。
2.3 完整枚举
织入方式只有这几类,其余都是它们的组合:
| 方式 | 织入时机 | 能拦截 | 额外依赖 | 典型场景 |
|---|---|---|---|---|
| Spring AOP 代理 | 运行期,Bean 初始化后 | 方法调用(经代理) | Spring 容器 | 事务、缓存、日志 |
| AspectJ 编译期 | ajc 编译时 | 方法、字段、构造器、静态块 | AspectJ 编译器 | 需要彻底拦截的库 |
| AspectJ 编译后 | 构建产物二次处理 | 同上 | 构建插件 | 无法改源码的依赖 |
| AspectJ 加载期 | 类加载时 | 同上 | -javaagent + aop.xml | 运行期无侵入 |
| 手写装饰器 | 编码时 | 显式包装的方法 | 无 | 少量、固定的横切 |
| 字节码库 | 运行期或构建期 | 取决于实现 | ByteBuddy、ASM | 框架与 Agent |
通知类型也是封闭集合:
| 通知 | 执行时机 | 能否改变返回值 | 典型用途 |
|---|---|---|---|
@Before | 目标方法前 | 不能 | 鉴权、参数校验、埋点 |
@AfterReturning | 正常返回后 | 不能 | 结果缓存、审计 |
@AfterThrowing | 抛出异常后 | 不能吞掉(除非重抛) | 告警、降级记录 |
@After | 无论成败,类似 finally | 不能 | 清理资源、计时结束 |
@Around | 包围整个调用 | 能 | 事务、重试、限流 |
2.4 关键数字与量级
| 指标 | 量级 | 说明 |
|---|---|---|
| 代理调用开销 | 10^2 ns | 反射加拦截器链,相对毫秒级 I/O 可忽略 |
| JDK 代理 | 每个接口 1 个 | 目标必须实现接口,否则退回 CGLIB |
| 通知链长度 | 3–5 层常见 | 事务、缓存、安全、指标常叠加 |
@Order 取值 | Integer.MIN_VALUE–MAX_VALUE | 数值越小优先级越高 |
| 事务 advisor 顺序 | LOWEST_PRECEDENCE | 默认最后执行,显式排序才会改变 |
| 切点解析 | 启动期一次 | 宽切点会扫描所有 Bean 的全部方法 |
| 自调用拦截次数 | 0 | 事务、缓存、安全注解一起失效 |
3 实践
3.1 最小示例
用 JDK 动态代理复现 Spring AOP 的核心:通知链、自调用绕过、代理身份。
import java.lang.reflect.InvocationHandler;
import java.lang.reflect.Proxy;
public final class ProxyDemo {
interface OrderService { void place(String id); void cancel(String id); }
static final class OrderServiceImpl implements OrderService {
@Override public void place(String id) {
System.out.println("[target] place " + id);
cancel(id); // 自调用:不经过代理
}
@Override public void cancel(String id) {
System.out.println("[target] cancel " + id);
}
}
static OrderService txProxy(OrderService target) {
InvocationHandler handler = (proxy, method, args) -> {
if (method.getDeclaringClass() == Object.class) {
return method.invoke(target, args);
}
System.out.println("[advice] begin " + method.getName());
try {
return method.invoke(target, args);
} finally {
System.out.println("[advice] end " + method.getName());
}
};
return (OrderService) Proxy.newProxyInstance(
ProxyDemo.class.getClassLoader(),
new Class<?>[] {OrderService.class}, handler);
}
public static void main(String[] args) {
OrderService service = txProxy(new OrderServiceImpl());
service.place("A1");
service.cancel("A1");
}
}
java ProxyDemo.java 运行后,place 与直接调用的 cancel 都有 begin/end,但 place 内部那次 cancel 没有——这正是 @Transactional 自调用失效的机械原因:目标对象里的 this 不是代理。
把 OrderServiceImpl 换成实现两个接口的类,Proxy.newProxyInstance 仍只认传入的接口列表;Spring 的 CGLIB 代理则生成子类,能代理类本身,但 final 方法依然无能为力。
3.2 常用操作与参数
| 目的 | 写法 | 说明 |
|---|---|---|
| 声明切面 | @Aspect @Component | 还需要 @EnableAspectJAutoProxy 或 Boot 自动配置 |
| 匹配方法签名 | execution(* com.acme..*Service.*(..)) | 尽量窄,避免匹配到框架类 |
| 按注解匹配 | @annotation(com.acme.Timed) | 注解保留策略必须是 RUNTIME |
| 环绕计时 | @Around 加 ProceedingJoinPoint | 必须 proceed(),异常要原样抛出 |
| 指定顺序 | @Order(10) 或实现 Ordered | 不要依赖默认顺序 |
| 加载期织入 | -javaagent:aspectjweaver.jar | 需要 aop.xml 与切面类路径 |
3.3 标准流程
- 先问是否真的需要切面:只有一两处、行为固定的横切,装饰器更直白。
- 选织入方式:Spring Bean 的方法级拦截用代理;需要字段、构造器或非 Spring 对象时上 AspectJ。
- 切点从窄到宽:先精确到注解或包,再考虑通配;每加一层通配都要评估启动扫描成本。
- 把通知写成无状态、幂等、可重入的实现,依赖通过构造器注入。
- 显式声明顺序,尤其是事务、缓存与安全三类切面的相对顺序。
3.4 与相邻技术的组合
- 声明式事务:
@Transactional本身就是一个 advisor,顺序与传播行为决定回滚是否生效。 - 缓存:
@Cacheable与事务的顺序会改变「读旧值」还是「写后读」的语义,通常缓存应在事务外层。 - 安全:方法级鉴权依赖代理,自调用同样会绕过,敏感操作要在入口统一校验。
- 观测:Micrometer 的
@Timed或自定义切面采集耗时,注意不要重复计时。 - 重试:Spring Retry 用切面实现,必须排在事务外层,否则每次重试都在已回滚的事务里。
3.5 选型维度
| 维度 | Spring AOP | AspectJ 编译期 | AspectJ 加载期 | 手写装饰器 |
|---|---|---|---|---|
| 拦截范围 | 方法(经代理) | 方法、字段、构造器 | 同左 | 显式包装的方法 |
| 织入时机 | 运行期 | 编译期 | 类加载期 | 编码期 |
| 构建复杂度 | 低 | 中,需换编译器 | 中,需 agent 与配置 | 无 |
| 启动开销 | 中,生成代理 | 低 | 中,改写字节码 | 最低 |
| 运行开销 | 每次调用走代理 | 接近无 | 接近无 | 直接调用 |
| 可调试性 | 调用栈多一层 | 栈与源码一致 | 栈与源码一致 | 完全显式 |
| 适用 | 业务 Bean | 库与框架 | 无法改源码的系统 | 少量固定逻辑 |
3.6 决策规则
- 目标是 Spring 容器里的 Bean,且只需要方法级拦截,用 Spring AOP。
- 需要拦截字段访问、构造器、静态方法,或目标不是 Spring Bean,用 AspectJ。
- 切点必须窄:优先
@annotation,其次包名前缀,最后才用宽通配。 - 事务、缓存、安全同时存在时,显式给每个切面
@Order并写进文档。 - 涉及自调用的逻辑,先拆 Bean;
AopContext只作为临时手段。
3.7 替代方案对比
| 方案 | 优势 | 代价 | 适用 |
|---|---|---|---|
| Spring AOP | 接入成本最低,生态完整 | 只拦方法、受代理限制 | 业务服务、事务缓存 |
| AspectJ | 拦截彻底,无代理开销 | 构建链改造,调试门槛高 | 框架、SDK、遗留系统 |
| 装饰器 | 显式、可读、易测 | 每个方法都要转发 | 少量固定横切 |
3.8 何时不该用
- 只有一两个方法需要日志或计时,直接写一行代码比切面更清楚。
- 切面里要写业务判断、访问数据库或调用远程服务时,它已经不再是横切逻辑。
- 目标类是
final或方法全是final时,不要再指望 Spring AOP,换 AspectJ 或重构。 - 热路径每秒百万次调用又叠加多层通知时,先量代理开销,再决定是否内联。
4 边界
4.1 典型故障
| 症状 | 根因 | 处理 |
|---|---|---|
@Transactional 不回滚 | 同类自调用,未经过代理 | 拆到另一个 Bean,或注入自身代理 |
private 方法上的注解无效 | 代理只拦截可重写的方法 | 改成 public 并经由代理调用 |
final 类启动报代理错误 | CGLIB 无法生成子类 | 去掉 final,或改用接口代理 |
| 切面顺序与预期相反 | 未声明 @Order,依赖默认顺序 | 显式设置顺序并写测试 |
@Around 后目标方法没执行 | 忘记调用 proceed() | 恢复 proceed(),返回值透传 |
| 异常类型变了 | 切面吞掉或包装了原异常 | 原样重抛,保留 cause |
| 加载期织入不生效 | 缺少 -javaagent 或 aop.xml | 补齐 agent 参数与切面声明 |
4.2 反模式
| 做法 | 后果 | 替代 |
|---|---|---|
| 切面里写业务分支 | 逻辑分散,无法单测 | 业务留在服务层,切面只做基础设施 |
| 切点匹配所有方法 | 启动慢、误拦框架方法 | 精确到注解或包 |
| 环绕通知改返回类型 | 调用方 ClassCastException | 保持签名与返回值不变 |
4.3 可观测信号
- 启动期:
AopUtils.isAopProxy的判定结果、日志里的 advisor 链、代理类名中的$$EnhancerBySpringCGLIB或$Proxy。 - 调用期:
@Around的耗时分布、通知链层数、事务提交与回滚日志、缓存命中率。 - 异常期:
UndeclaredThrowableException与InvocationTargetException的出现次数、被切面包装后的栈顶。 - 回归:为自调用、
private、final三类失效场景各保留一个测试用例。
4.4 安全 / 性能 / 一致性边界
- 安全边界:鉴权切面被自调用绕过就是真实的越权漏洞;注解不是强制点,入口过滤器与方法级校验要形成双保险。
- 性能边界:代理调用本身是百纳秒级,但通知里的远程调用与同步锁会被放大到毫秒级;切点过宽会把启动成本转成发布风险。
- 一致性边界:事务、缓存、重试的顺序改变语义,
@Order必须被视为契约的一部分;AspectJ 织入的行为在源码里不可见,需要额外的文档与测试。