Spring Boot AOP 全面解析（原理 + 实战 + 场景）

AOP（面向切面编程）是 Spring 核心特性之一，Spring Boot 对 AOP 做了轻量化封装，无需复杂配置即可快速实现日志记录、性能监控、权限校验、事务管理等横切逻辑，大幅提升代码复用性和可维护性。

一、核心概念（快速理解）

二、快速上手（Spring Boot 集成 AOP）

1. 引入依赖

xml

<!-- Spring Boot AOP 核心依赖 --> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-aop</artifactId> </dependency>

2. 编写切面类（实战：日志记录）

java

运行

import org.aspectj.lang.JoinPoint; import org.aspectj.lang.ProceedingJoinPoint; import org.aspectj.lang.annotation.*; import org.slf4j.Logger; import org.slf4j.LoggerFactory; import org.springframework.stereotype.Component; // 1. 标记为切面类 + 交给 Spring 管理 @Aspect @Component public class LogAspect { private static final Logger log = LoggerFactory.getLogger(LogAspect.class); // 2. 定义切入点：匹配 com.example.demo.service 包下所有类的所有方法 @Pointcut("execution(* com.example.demo.service.*.*(..))") public void servicePointcut() {} // 3. 前置通知：记录方法调用信息 @Before("servicePointcut()") public void beforeMethod(JoinPoint joinPoint) { String className = joinPoint.getTarget().getClass().getName(); String methodName = joinPoint.getSignature().getName(); Object[] args = joinPoint.getArgs(); log.info("【前置通知】调用方法：{}.{}，参数：{}", className, methodName, args); } // 4. 环绕通知：监控方法执行耗时 @Around("servicePointcut()") public Object aroundMethod(ProceedingJoinPoint joinPoint) throws Throwable { long startTime = System.currentTimeMillis(); // 执行目标方法 Object result = joinPoint.proceed(); long costTime = System.currentTimeMillis() - startTime; log.info("【环绕通知】方法 {} 执行耗时：{}ms", joinPoint.getSignature().getName(), costTime); return result; } // 5. 返回通知：记录方法返回值 @AfterReturning(value = "servicePointcut()", returning = "result") public void afterReturningMethod(JoinPoint joinPoint, Object result) { log.info("【返回通知】方法 {} 返回结果：{}", joinPoint.getSignature().getName(), result); } // 6. 异常通知：记录方法异常信息 @AfterThrowing(value = "servicePointcut()", throwing = "e") public void afterThrowingMethod(JoinPoint joinPoint, Exception e) { log.error("【异常通知】方法 {} 抛出异常：{}", joinPoint.getSignature().getName(), e.getMessage(), e); } }

3. 测试目标方法

java

运行

import org.springframework.stereotype.Service; @Service public class UserService { public String getUserInfo(Long id) { // 模拟业务逻辑 if (id <= 0) { throw new IllegalArgumentException("用户ID不能为负数"); } return "用户ID：" + id + "，姓名：张三"; } }

4. 运行效果

调用getUserInfo(1L)会输出：

plaintext

【前置通知】调用方法：com.example.demo.service.UserService.getUserInfo，参数：[1] 【环绕通知】方法 getUserInfo 执行耗时：2ms 【返回通知】方法 getUserInfo 返回结果：用户ID：1，姓名：张三

调用getUserInfo(-1L)会输出：

plaintext

【前置通知】调用方法：com.example.demo.service.UserService.getUserInfo，参数：[-1] 【异常通知】方法 getUserInfo 抛出异常：用户ID不能为负数

三、进阶用法

1. 切入点表达式（常用）

2. 自定义注解 + AOP（更灵活）

java

运行

// 自定义注解 @Target(ElementType.METHOD) @Retention(RetentionPolicy.RUNTIME) public @interface Log { String desc() default ""; // 日志描述 } // 切面匹配注解 @Pointcut("@annotation(com.example.demo.annotation.Log)") public void annotationPointcut() {} // 使用注解 @Service public class OrderService { @Log(desc = "创建订单") public String createOrder(String orderNo) { return "订单创建成功：" + orderNo; } }

四、注意事项

1. 代理机制：Spring AOP 默认使用 JDK 动态代理（针对接口），无接口时自动切换为 CGLIB 代理；可通过@EnableAspectJAutoProxy(proxyTargetClass = true)强制使用 CGLIB。
2. 内部方法调用：目标类内部调用自身方法（如A.method1()调用A.method2()），method2的切面不会生效（代理对象未被触发），可通过注入自身 Bean 解决。
3. 性能影响：AOP 基于动态代理实现，少量切面对性能影响可忽略；大量复杂环绕通知需注意优化逻辑。
4. 优先级：多个切面可通过@Order(n)指定执行顺序，n 越小优先级越高。

五、典型应用场景

1. 日志审计：记录接口调用的请求参数、响应结果、操作人、操作时间。
2. 性能监控：统计接口响应时间，识别慢接口。
3. 权限控制：校验用户是否有接口访问权限。
4. 事务管理：通过@Transactional（底层基于 AOP）控制事务边界。
5. 缓存控制：缓存方法返回结果，减少重复计算。
6. 参数校验：统一校验接口入参的合法性。