当前位置：首页 > news >正文

【硬核实战】Spring AOP 从原理到落地：3 个可运行案例带你吃透切面编程

news 2026/4/22 2:46:17

作者风格：MY_TEUCK 硬核实战风 + AI 应用落地风
读者对象：Java 学习者 / Spring Boot 初中级开发者
阅读目标：不仅知道 AOP 是什么，更知道什么时候用、怎么写、怎么避坑

前言

很多同学第一次学 AOP（面向切面编程）会有两个误区：

只会背概念：Aspect、Pointcut、Advice，但写不出可用代码。
只会抄例子：日志打印能跑，但一到业务场景（权限、幂等、审计）就不会落地。

这篇文章直接走实战路线：
先把思想讲透，再给你可运行代码，最后落到真实业务场景和面试答法，确保你学完就能用。

一、概念解析：AOP 到底是什么？

1.1 一句话定义

AOP 是把“横切关注点”从业务代码中抽离出来，统一管理的一种编程思想。

什么叫横切关注点？

不是核心业务本身（比如下单、支付、查询订单）
但很多地方都要做（比如日志、权限、事务、审计、幂等）

1.2 为什么需要 AOP？

如果不用 AOP，代码常变成这样：

每个方法都写一遍日志
每个接口都写一遍权限判断
每次更新都手动补审计字段

结果是：重复、易漏、难维护。

1.3 AOP 与 OOP 的关系

OOP：负责纵向建模（订单服务、商品服务、用户服务）
AOP：负责横向增强（日志、权限、监控、审计）

它们不是替代关系，而是互补关系。

二、原理：Spring AOP 是怎么工作的？

Spring AOP 的核心不是“魔法”，而是代理模式。

2.1 执行链路

Spring 启动扫描到切面（@Aspect）
根据切点（Pointcut）匹配目标方法
为目标 Bean 创建代理对象（JDK 动态代理 / CGLIB）
你调用的是代理对象
代理在合适时机执行通知（Advice）再执行目标方法

2.2 关键术语（必须会）

Aspect（切面）：承载增强逻辑的类
Pointcut（切点）：定义拦截哪些方法
Advice（通知）：定义何时增强（前置/后置/环绕/异常）
JoinPoint（连接点）：可被增强的方法执行点
Weaving（织入）：把切面应用到目标对象的过程

三、实战代码：3 个可运行 AOP 案例

下面示例基于 Spring Boot，直接可用。

3.1 准备依赖

<dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-aop</artifactId></dependency>

3.2 案例一：接口耗时统计（最直观）

（1）切面代码

packagecom.example.aop;importlombok.extern.slf4j.Slf4j;importorg.aspectj.lang.ProceedingJoinPoint;importorg.aspectj.lang.annotation.Around;importorg.aspectj.lang.annotation.Aspect;importorg.springframework.stereotype.Component;@Aspect@Component@Slf4jpublicclassCostTimeAspect{@Around("execution(* com.example.service..*(..))")publicObjectrecordTime(ProceedingJoinPointpjp)throwsThrowable{longstart=System.currentTimeMillis();try{returnpjp.proceed();}finally{longcost=System.currentTimeMillis()-start;log.info("method={} cost={}ms",pjp.getSignature().toShortString(),cost);}}}

（2）业务代码

packagecom.example.service;importorg.springframework.stereotype.Service;@ServicepublicclassOrderService{publicStringcreateOrder()throwsInterruptedException{Thread.sleep(120);return"ok";}}

3.3 案例二：自定义注解 + 权限校验

（1）定义注解

packagecom.example.aop;importjava.lang.annotation.*;@Target(ElementType.METHOD)@Retention(RetentionPolicy.RUNTIME)public@interfaceRequiresRole{Stringvalue();}

（2）切面校验

packagecom.example.aop;importorg.aspectj.lang.JoinPoint;importorg.aspectj.lang.annotation.Aspect;importorg.aspectj.lang.annotation.Before;importorg.aspectj.lang.reflect.MethodSignature;importorg.springframework.stereotype.Component;@Aspect@ComponentpublicclassRoleCheckAspect{@Before("@annotation(com.example.aop.RequiresRole)")publicvoidcheckRole(JoinPointjoinPoint){MethodSignaturesignature=(MethodSignature)joinPoint.getSignature();RequiresRolerequiresRole=signature.getMethod().getAnnotation(RequiresRole.class);StringneedRole=requiresRole.value();// 示例：真实项目可从 ThreadLocal / JWT 中取当前用户角色StringcurrentRole="USER";if(!needRole.equals(currentRole)){thrownewRuntimeException("无权限访问，needRole="+needRole);}}}

（3）使用注解

packagecom.example.service;importcom.example.aop.RequiresRole;importorg.springframework.stereotype.Service;@ServicepublicclassAdminService{@RequiresRole("ADMIN")publicStringdeleteUser(){return"deleted";}}

3.4 案例三：公共字段自动填充（企业项目高频）

这个场景是很多管理系统都存在的真实需求：

新增时自动填充createTime/createUser/updateTime/updateUser
更新时自动填充updateTime/updateUser

（1）注解 + 操作类型

publicenumOperationType{INSERT,UPDATE}

@Target(ElementType.METHOD)@Retention(RetentionPolicy.RUNTIME)public@interfaceAutoFill{OperationTypevalue();}

（2）切面核心逻辑

@Aspect@ComponentpublicclassAutoFillAspect{@Before("execution(* com.example.mapper..*(..)) && @annotation(com.example.aop.AutoFill)")publicvoidautoFill(JoinPointjoinPoint)throwsException{MethodSignaturesignature=(MethodSignature)joinPoint.getSignature();AutoFillautoFill=signature.getMethod().getAnnotation(AutoFill.class);OperationTypetype=autoFill.value();Objectentity=joinPoint.getArgs()[0];LocalDateTimenow=LocalDateTime.now();LongcurrentUserId=1L;// 示例，真实项目从上下文取if(type==OperationType.INSERT){entity.getClass().getMethod("setCreateTime",LocalDateTime.class).invoke(entity,now);entity.getClass().getMethod("setCreateUser",Long.class).invoke(entity,currentUserId);}entity.getClass().getMethod("setUpdateTime",LocalDateTime.class).invoke(entity,now);entity.getClass().getMethod("setUpdateUser",Long.class).invoke(entity,currentUserId);}}