Spring AOP日志切面需满足代理条件才能生效：目标类必须由Spring容器管理、切面类需被扫描且非final、调用必须走代理路径；@Before无法获取返回值，@AfterReturning为null多因切点不匹配或方法抛异常；@Around是唯一能控制流程并获取参数、返回值、异常的通知类型。
Spring AOP 日志切面不是加个 @Aspect 就能自动记录有效日志的——它默认不拦截 private 方法、不生效于本类内部调用、不捕获异常时的返回值，而且 @Before 根本拿不到方法返回结果。
为什么 @Before 拿不到返回值，而 @AfterReturning 却经常 null？
因为 @Before 在目标方法执行前触发，自然没有返回值；但 @AfterReturning 的返回值为 null，通常是因为切点表达式没匹配到实际执行的方法签名，或者目标方法抛了异常（此时该通知根本不会触发）。
- 确保切点使用
execution(* com.example.service.*.*(..))这类完整表达式，别漏掉包名或返回类型 - 如果方法声明了泛型返回值（如
ResponseEntity<string></string>），切点里写ResponseEntity就够，JVM 擦除后不认泛型 -
@AfterReturning(pointcut = "logPointcut()", returning = "result")中的result变量名必须和注解参数完全一致，大小写敏感
@Around 是唯一能真正控制流程并拿到入参/返回值/异常的方案
前置、后置、返回、异常通知各自孤立，没法共享变量或修改执行流；@Around 用一个通知就能覆盖全部需求，且能决定是否放行、替换返回值、统一包装异常。
Java 接口排错助手
下载
在调试 Java 后端 API 故障时使用此技能，尤其适用于以下任务：分析日志、跨 Controller、Service 和 Mapper 层追踪请求、定位异常根因、检查 SQL 执行或参数流转，以及生成简洁的诊断结论与修复方案。
- 必须显式调用
proceed()，否则目标方法永不执行 - 捕获
Throwable而非仅Exception，否则Error（如OutOfMemoryError）会被忽略 - 日志中打印参数建议用
Arrays.toString(joinPoint.getArgs())，别直接toString()—— 数组会输出哈希值
@Around("execution(* com.example.controller..*.*(..))")
public Object logExecutionTime(ProceedingJoinPoint joinPoint) throws Throwable {
long start = System.currentTimeMillis();
String signature = joinPoint.getSignature().toShortString();
try {
Object result = joinPoint.proceed(); // 执行原方法
long duration = System.currentTimeMillis() - start;
log.info("{} executed in {}ms → {}", signature, duration, result);
return result;
} catch (Throwable e) {
long duration = System.currentTimeMillis() - start;
log.error("{} failed after {}ms with {}", signature, duration, e.getMessage(), e);
throw e;
}
}
切面不生效？先确认这三个硬性条件是否满足
Spring AOP 是基于代理的，所有限制都源于此。不满足任一条件，切面就静默失效，连报错都不会有。
立即学习“Java免费学习笔记（深入）”；
- 目标类必须由 Spring 容器管理（即被
@Service、@Controller等标注，且实际从ApplicationContext获取，而非new出来） - 切面类本身必须被 Spring 扫描到：加
@Component或在配置类中@Bean注册，且不能是final类（CGLIB 代理失败） - 调用必须走代理路径：Controller 调 Service 可以，但 Service 内部
this.method()调用另一个方法，AOP 完全不介入
最常被忽略的是：日志切面里直接用 System.out.println 测试，结果看不到输出——不是切面没跑，是日志框架（如 Logback）把级别设成了 WARN 以上，而你的 log.info 被静默丢弃了。
