Spring AOP日志记录：@Aspect与通知使用详解

Spring AOP日志切面远非简单添加@Aspect注解就能“开箱即用”，其背后严格的代理机制决定了它只对Spring容器管理的Bean、通过代理路径调用的方法生效，且对private方法、本类内部调用完全失效；@Before无法获取返回值是设计使然，而@AfterReturning常为null往往源于切点不匹配或方法抛异常导致通知未触发；真正灵活可控的日志方案必须依赖@Around——它唯一支持拦截全流程、捕获参数/返回值/异常、决定是否执行原方法、统一处理错误甚至修改结果，但务必显式调用proceed()并捕获Throwable以覆盖Error；同时需警惕日志级别配置、泛型擦除、数组打印等细节陷阱，否则看似配置正确却日志静默、切面“失踪”。

Spring AOP 日志切面不是加个 @Aspect 就能自动记录有效日志的——它默认不拦截 private 方法、不生效于本类内部调用、不捕获异常时的返回值，而且 @Before 根本拿不到方法返回结果。

为什么 @Before 拿不到返回值，而 @AfterReturning 却经常 null？

因为 @Before 在目标方法执行前触发，自然没有返回值；但 @AfterReturning 的返回值为 null，通常是因为切点表达式没匹配到实际执行的方法签名，或者目标方法抛了异常（此时该通知根本不会触发）。

• 确保切点使用 execution(* com.example.service.*.*(..)) 这类完整表达式，别漏掉包名或返回类型
• 如果方法声明了泛型返回值（如 ResponseEntity），切点里写 ResponseEntity 就够，JVM 擦除后不认泛型
• @AfterReturning(pointcut = "logPointcut()", returning = "result") 中的 result 变量名必须和注解参数完全一致，大小写敏感

@Around 是唯一能真正控制流程并拿到入参/返回值/异常的方案

前置、后置、返回、异常通知各自孤立，没法共享变量或修改执行流；@Around 用一个通知就能覆盖全部需求，且能决定是否放行、替换返回值、统一包装异常。

• 必须显式调用 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 是基于代理的，所有限制都源于此。不满足任一条件，切面就静默失效，连报错都不会有。

• 目标类必须由 Spring 容器管理（即被 @Service、@Controller 等标注，且实际从 ApplicationContext 获取，而非 new 出来）
• 切面类本身必须被 Spring 扫描到：加 @Component 或在配置类中 @Bean 注册，且不能是 final 类（CGLIB 代理失败）
• 调用必须走代理路径：Controller 调 Service 可以，但 Service 内部 this.method() 调用另一个方法，AOP 完全不介入

最常被忽略的是：日志切面里直接用 System.out.println 测试，结果看不到输出——不是切面没跑，是日志框架（如 Logback）把级别设成了 WARN 以上，而你的 log.info 被静默丢弃了。

今天关于《Spring AOP日志记录：@Aspect与通知使用详解》的内容就介绍到这里了，是不是学起来一目了然！想要了解更多关于的内容请关注golang学习网公众号！