1. 项目概述为什么我们需要深入理解JoinPoint与切点表达式如果你正在用SpringBoot开发并且已经接触到了AOP面向切面编程那你大概率已经用过Before、After这样的注解了。但不知道你有没有遇到过这样的困惑在通知方法里除了打印个日志好像也不知道还能干点啥或者想精准地拦截某个特定包下、带有特定注解的方法时那个Pointcut表达式怎么写都觉得不对劲要么拦截多了要么漏掉了关键方法。我自己在带团队和做项目的过程中发现很多开发者对Spring AOP的使用停留在“依葫芦画瓢”的阶段。大家知道要加个Aspect注解知道几个通知类型但一旦涉及到从被拦截的方法里拿参数、拿返回值、甚至修改参数或者需要编写复杂的拦截规则时就有点抓瞎了。核心的症结往往在于两个东西没吃透一个是JoinPoint连接点对象它封装了当前拦截到的那个方法的所有信息是我们的“情报中心”另一个就是切点表达式它决定了我们的“狙击枪”到底瞄准哪里精度如何。JoinPoint和切点表达式是Spring AOP这座大厦的承重墙。JoinPoint让你在切面里“看得见”业务方法的内里而切点表达式则让你“指得准”要增强的目标。搞懂了它们你就能实现更优雅的日志记录、更灵活的权限校验、更强大的事务管理和性能监控而不是仅仅打印一句“方法执行了”。这篇文章我就结合自己踩过的坑和总结的最佳实践带你彻底搞明白这两个核心概念让你写的AOP代码既强大又精准。2. 核心基石JoinPoint对象全解与实战应用JoinPoint接口是AOP联盟定义的标准在Spring AOP中它代表程序执行过程中一个明确的点比如方法的调用或异常的抛出。在通知方法中我们可以通过声明一个JoinPoint类型的参数来获取这个点的所有上下文信息。这是切面能够干预业务逻辑的基础。2.1 JoinPoint的核心方法与信息提取JoinPoint提供了丰富的方法最常用的几个如下getSignature(): 获取连接点的签名返回一个Signature对象。这可能是我们最常用的方法因为它能告诉我们当前拦截的是什么。Signature.getDeclaringType(): 获取声明此方法的类Class对象。Signature.getName(): 获取方法名。Signature.toLongString()/toShortString(): 获取方法完整或简短的字符串表示包含类名、方法名、参数类型。getArgs(): 获取当前拦截方法的传入参数以一个Object[]数组返回。这是动态处理业务参数的关键。getTarget(): 获取被代理的目标对象即我们原本的Service/Controller实例。getThis(): 获取当前的AOP代理对象本身。在Spring AOP中这通常就是一个JDK动态代理或CGLIB代理对象。光看概念有点抽象我们直接看一个实战中的例子。假设我们有一个用户服务要记录所有服务方法的入参、出参和执行时间。Aspect Component public class ServiceLogAspect { private static final Logger log LoggerFactory.getLogger(ServiceLogAspect.class); Around(execution(* com.example.demo.service.*.*(..))) public Object logAround(ProceedingJoinPoint joinPoint) throws Throwable { // ProceedingJoinPoint是JoinPoint的子接口专用于Around通知多了proceed()方法。 String className joinPoint.getTarget().getClass().getSimpleName(); String methodName joinPoint.getSignature().getName(); Object[] args joinPoint.getArgs(); // 1. 记录入参 log.info([{}#{}] 方法开始执行入参: {}, className, methodName, Arrays.toString(args)); long startTime System.currentTimeMillis(); Object result null; try { // 执行目标方法 result joinPoint.proceed(); long elapsedTime System.currentTimeMillis() - startTime; // 2. 记录出参和执行时间 log.info([{}#{}] 方法执行成功耗时: {}ms结果: {}, className, methodName, elapsedTime, result); } catch (Exception e) { long elapsedTime System.currentTimeMillis() - startTime; // 3. 记录异常情况 log.error([{}#{}] 方法执行异常耗时: {}ms异常: {}, className, methodName, elapsedTime, e.getMessage(), e); throw e; // 异常要继续抛出保证业务逻辑感知 } return result; } }在这个例子里我们通过joinPoint.getTarget()拿到实际的服务类实例再取类名。通过joinPoint.getSignature().getName()拿到方法名。最关键的是joinPoint.getArgs()它让我们能把方法的参数记录到日志里。而joinPoint.proceed()则是Around通知的灵魂它代表继续执行原业务方法。注意直接使用Arrays.toString(args)记录参数在对象比较复杂时如包含循环引用可能导致栈溢出或日志过长。生产环境建议使用JSON序列化工具如Jackson的ObjectMapper并做长度截断或者只记录关键字段。2.2 ProceedingJoinPoint的进阶操控Around通知使用的是ProceedingJoinPoint它扩展了JoinPoint核心就是那个proceed()方法。这给了我们最大的操控权我们可以在执行目标方法前后做任何事甚至可以决定是否执行、如何执行目标方法以及修改它的返回值。场景一参数校验与修改假设我们希望对某些方法的字符串参数自动做Trim操作。Around(annotation(com.example.demo.annotation.AutoTrim)) public Object autoTrimParams(ProceedingJoinPoint pjp) throws Throwable { Object[] args pjp.getArgs(); for (int i 0; i args.length; i) { if (args[i] instanceof String) { args[i] ((String) args[i]).trim(); } // 还可以递归处理对象中的String字段这里简化 } // 使用修改后的参数数组继续执行 return pjp.proceed(args); }这里我们通过pjp.getArgs()拿到参数数组修改后再调用pjp.proceed(args)将修改后的参数传入。这是一个非常强大的特性但使用需谨慎避免破坏业务逻辑的预期。场景二缓存与快速返回实现一个简单的环绕缓存如果缓存命中则直接返回不执行目标方法。Around(execution(* com.example.demo.service.UserService.getUserById(Long)) args(userId)) public Object cacheUser(ProceedingJoinPoint pjp, Long userId) throws Throwable { String cacheKey user: userId; Object cachedValue cache.get(cacheKey); if (cachedValue ! null) { log.info(缓存命中key: {}, cacheKey); return cachedValue; // 直接返回不执行proceed() } log.info(缓存未命中执行查询key: {}, cacheKey); Object result pjp.proceed(); // 执行真实的数据库查询 cache.put(cacheKey, result, 5, TimeUnit.MINUTES); return result; }这个例子展示了Around通知可以根据条件缓存是否命中来决定是否调用proceed()。如果不调用则目标业务方法根本不会执行。实操心得Around功能最强但也最容易出错。务必在try-catch-finally块中妥善处理proceed()的调用和异常确保资源释放和事务边界正确。另外修改参数或返回值时一定要清楚对上下游业务的影响。3. 狙击枪的准星切点表达式语法精讲切点表达式决定了你的切面要“织入”到程序的哪些位置。Spring AOP主要使用AspectJ的切点表达式语言功能非常强大。表达式主要由指示器Designators和通配符组成。3.1 execution最常用的方法匹配指示器这是你几乎每天都会用到的指示器语法如下execution(modifiers-pattern? ret-type-pattern declaring-type-pattern?name-pattern(param-pattern) throws-pattern?)其中带?的是可选部分。ret-type-pattern: 返回值类型*代表任意类型。declaring-type-pattern: 方法所属的类名模式。name-pattern: 方法名模式。param-pattern: 参数模式这是最容易出错的地方。throws-pattern: 异常类型很少用。我们来看一些具体例子和解析表达式示例含义解析execution(public * *(..))匹配所有public方法。execution(* set*(..))匹配所有以“set”开头的方法。execution(* com.example.service.*.*(..))匹配com.example.service包下不含子包的任何类的任何方法。execution(* com.example.service..*.*(..))匹配com.example.service包及其所有子包下任何类的任何方法。两个点..代表当前包及子包这是关键。execution(* com.example.service.UserService.*(..))匹配UserService接口/类的所有方法。execution(* com.example.service.*Service.*(..))匹配包下以Service结尾的类的所有方法。execution(* com.example.service.UserService.save*(..))匹配UserService中所有以save开头的方法。execution(* *(java.lang.String, ..))匹配第一个参数是String后面可以有任意个任意类型参数的方法。execution(* *(org.springframework.web.bind.annotation.RequestBody (*), ..))匹配第一个参数被RequestBody注解修饰的方法需AspectJ完整支持Spring AOP可能受限。参数模式(param-pattern)详解(): 匹配无参数方法。(..): 匹配任意数量、任意类型的参数包括无参。最常用。(*): 匹配一个任意类型的参数。(*, String): 匹配两个参数第二个是String类型。(java.lang.Long, ..): 匹配第一个参数是Long后面跟任意参数。3.2 within, this, target, args 与 annotation除了execution还有其他指示器用于更精细或不同维度的匹配。within: 匹配指定类型内的方法。比execution在类级别上更简洁。within(com.example.service.UserService): 匹配UserService类的所有方法。within(com.example.service.*Service): 匹配包下以Service结尾的类的所有方法。within(org.springframework.stereotype.Service *): 匹配所有被Service注解的类的所有方法。这个非常实用thisvstarget: 这两个容易混淆。this(com.example.service.UserService):匹配代理对象AOP Proxy的类型是UserService或其子类。在JDK动态代理时代理对象实现接口所以this匹配接口。target(com.example.service.UserService):匹配目标对象被代理的实际对象的类型是UserService或其子类。通常我们更关心目标对象所以target更常用。简单记忆this看代理Proxytarget看目标Target。在CGLIB代理类代理时两者通常一致。args: 匹配运行时参数类型符合指定模式的方法。它与execution中的参数模式不同args更动态且可以将参数绑定到通知方法的参数上。Before(execution(* *..find*(..)) args(id,..))public void logFind(JoinPoint jp, Long id) { ... }这里args(id,..)不仅要求方法第一个参数是Long或可自动转换还将该参数值绑定到了通知方法的id参数上非常方便。annotation:这是我认为最优雅、侵入性最低的匹配方式。它匹配带有指定注解的方法。Pointcut(annotation(com.example.demo.annotation.OperateLog))public void operateLogPointcut() {}这样我只需要在需要记录操作日志的方法上加上OperateLog注解即可切点表达式变得非常清晰和聚焦。3.3 组合使用与运算符切点表达式可以通过逻辑运算符与、||或、!非进行组合实现复杂逻辑。// 组合示例记录Service层中非查询方法不以get/find开头的执行 Pointcut(within(org.springframework.stereotype.Service *)) public void serviceLayer() {} Pointcut(execution(* *..get*(..)) || execution(* *..find*(..))) public void queryOperation() {} Before(serviceLayer() !queryOperation()) public void logNonQuery(JoinPoint jp) { // 记录非查询操作 }注意事项切点表达式在应用启动时会被解析和优化。过于复杂的表达式尤其是大量使用||可能会轻微影响启动性能。建议将通用的切点定义为Pointcut方法然后通过方法名引用这样既清晰又可复用。4. 实战构建一个可复用的操作日志切面现在我们把JoinPoint和切点表达式结合起来实现一个生产级可用的操作日志切面。这个切面会记录谁、在什么时候、对什么数据、做了什么事情、结果如何。4.1 定义自定义注解与日志实体首先我们定义一个注解用于标记需要记录日志的方法。Target(ElementType.METHOD) Retention(RetentionPolicy.RUNTIME) public interface OperateLog { /** 业务模块 */ String module() default ; /** 操作类型如新增、删除、修改、查询 */ String type() default ; /** 操作描述支持SpEL表达式从方法参数中取值 */ String desc() default ; }然后定义一个日志实体用于存储和传递日志信息。Data public class OperateLogInfo { private String module; private String type; private String desc; private String operator; // 操作人从Session或Token中获取 private String method; private String params; private String result; private Boolean success; private String errorMsg; private Long costTime; private LocalDateTime operateTime; }4.2 实现切面逻辑核心切面实现如下这里我们使用Around通知因为它能完美控制方法执行前后并获取执行结果和耗时。Aspect Component Slf4j public class OperateLogAspect { Autowired private OperateLogService logService; // 假设有一个服务用于保存日志 Autowired private OperatorHolder operatorHolder; // 一个工具类用于获取当前登录用户 // 定义切点所有被OperateLog注解的方法 Pointcut(annotation(com.example.demo.annotation.OperateLog)) public void operateLogPointCut() {} Around(operateLogPointCut()) public Object around(ProceedingJoinPoint pjp) throws Throwable { OperateLogInfo logInfo new OperateLogInfo(); long startTime System.currentTimeMillis(); Object result null; boolean success true; String errorMsg null; try { // 1. 获取方法签名和注解信息 MethodSignature signature (MethodSignature) pjp.getSignature(); Method method signature.getMethod(); OperateLog operateLog method.getAnnotation(OperateLog.class); // 2. 解析SpEL表达式获取动态的操作描述 String desc parseSpEL(operateLog.desc(), method, pjp.getArgs()); // 3. 填充基础日志信息 logInfo.setModule(operateLog.module()); logInfo.setType(operateLog.type()); logInfo.setDesc(desc); logInfo.setMethod(pjp.getTarget().getClass().getName() # method.getName()); logInfo.setOperator(operatorHolder.getCurrentOperator()); // 获取操作人 logInfo.setParams(parseParams(pjp.getArgs())); // 将参数序列化为JSON字符串 // 4. 执行目标方法 result pjp.proceed(); logInfo.setResult(parseResult(result)); // 序列化结果注意脱敏 } catch (Throwable e) { success false; errorMsg e.getMessage(); throw e; // 异常继续抛出 } finally { // 5. 最终记录日志 long endTime System.currentTimeMillis(); logInfo.setCostTime(endTime - startTime); logInfo.setSuccess(success); logInfo.setErrorMsg(errorMsg); logInfo.setOperateTime(LocalDateTime.now()); // 异步保存日志避免影响主业务性能 CompletableFuture.runAsync(() - { try { logService.save(logInfo); } catch (Exception e) { log.error(保存操作日志失败, e); } }); } return result; } // 解析SpEL表达式的方法简化版实际需注入SpEL解析器 private String parseSpEL(String spEL, Method method, Object[] args) { if (StringUtils.isEmpty(spEL)) { return ; } // 这里需要实现SpEL解析逻辑将方法参数绑定到表达式上下文中 // 例如 desc “删除用户#{args[0]}” - “删除用户张三” // 具体实现略 return spEL; } private String parseParams(Object[] args) { // 使用Jackson等工具将args序列化为JSON注意过滤密码等敏感信息 try { return new ObjectMapper().writeValueAsString(args); } catch (JsonProcessingException e) { return 参数序列化失败; } } private String parseResult(Object result) { /* 类似parseParams */ } }4.3 在业务方法上使用最后在需要记录日志的业务方法上轻松地加上注解即可。Service public class UserServiceImpl implements UserService { Override OperateLog(module 用户管理, type 新增, desc 新增用户用户名#{args[0].username}) public User createUser(UserDTO userDTO) { // ... 业务逻辑 return user; } Override OperateLog(module 用户管理, type 删除, desc 删除用户用户ID#{args[0]}) public void deleteUser(Long userId) { // ... 业务逻辑 } }这个实战案例展示了如何将JoinPoint获取方法、参数、目标对象和基于注解的切点表达式annotation紧密结合构建出一个高内聚、低耦合、声明式的通用日志组件。通过SpEL表达式我们甚至能在注解中动态地引用方法参数让日志描述更加智能。5. 避坑指南与性能优化在实际项目中大规模使用AOP尤其是复杂的切点表达式和重量级的Around通知时会遇到不少坑。这里分享几个最常见的。5.1 常见问题排查问题1切面不生效这是新手最常遇到的问题。排查步骤检查切面类是否被Spring管理确保你的Aspect类上有Component或其它Spring Stereotype注解或者已经在配置类中通过Bean声明。检查切点表达式是否正确特别是包路径、方法名匹配。使用execution(* com.example..*.*(..))这样的宽泛表达式先测试再逐步收窄。检查目标方法是否被代理Spring AOP基于代理。对于同类内部方法调用即一个Service方法A调用了同一个Service的另一个方法B由于调用走的是this引用而非代理对象切面是不会生效的。这是最大的一个坑解决方案注入自身代理Autowired private MyService self;然后调用self.methodB()或者使用AspectJ的编译时/加载时织入LTW。检查EnableAspectJAutoProxy在Spring Boot中默认已启用。如果是纯Spring项目需要在配置类上加上此注解。问题2获取的参数或返回值是null或不对参数为null检查getArgs()返回的数组索引是否正确。注意args指示器绑定参数时通知方法参数名需与切点表达式中的绑定名一致或使用Before(pointcut() args(id))并指定参数Long id。返回值类型转换异常在AfterReturning中使用returning属性绑定的返回值其类型必须与通知方法参数类型兼容。如果目标方法返回Object而你用String去接会报错。问题3循环依赖如果切面AspectA依赖了ServiceB而ServiceB的方法又被AspectA切面拦截在Spring创建Bean时可能会形成循环依赖。Spring通常能处理Setter注入的循环依赖但构造函数注入可能会出问题。解决方案尽量避免在切面中注入会被自己拦截的Bean。如果必须考虑使用Lazy注解延迟注入或者将切面逻辑移到不会被拦截的工具类中。5.2 性能考量与最佳实践切点表达式尽量精确避免使用execution(* *..*.*(..))这种匹配所有方法的表达式。范围越大Spring在每次方法调用时判断是否要执行通知的成本就越高。尽量使用within()限定到特定包或使用annotation精确打击。通知方法本身要轻量尤其是在Around和Before中。如果通知方法里执行了数据库查询、远程调用等耗时操作会显著拖慢每个被拦截的业务方法。日志记录、权限校验等操作应考虑异步化如上面实战案例中使用CompletableFuture.runAsync。谨慎使用AroundAround功能最强但开销也最大。如果只是需要在方法执行前或后做一个简单动作如记录开始、清理资源优先考虑Before或After。避免在切点表达式中使用bean()指示器进行大量匹配bean(service*)虽然方便但Spring需要遍历所有Bean名称进行模式匹配在Bean很多时可能影响启动速度。使用编译时织入CTW或加载时织入LTW应对性能瓶颈Spring AOP的运行时代理JDK/CGLIB是有开销的。如果AOP成为性能瓶颈通常在高频方法调用时可以考虑使用AspectJ的CTW/LTW它直接在字节码层面进行织入没有代理开销。但配置更复杂且对“同类内部调用”问题也无能为力因为这是代码结构问题。5.3 设计模式建议单一职责一个切面只做一件事。不要在一个Aspect类里既做日志又做缓存又做事务。拆分成LoggingAspect、CachingAspect、TransactionalAspect等这样更清晰也便于管理和排序。使用Order或实现Ordered接口当多个切面作用于同一个连接点时执行顺序很重要。例如通常事务切面Transactional应该先于缓存切面执行。你可以用Order(1)注解来指定顺序数字越小优先级越高越先执行。拥抱注解驱动相比于在XML或Java Config中定义复杂的切点表达式使用自定义注解如OperateLog、CacheResult来标记需要被增强的方法是一种更声明式、更清晰、耦合度更低的方式。业务开发者只需要关心注解而不需要知道背后复杂的AOP配置。理解JoinPoint和切点表达式是解锁Spring AOP全部潜力的钥匙。从简单的日志记录到复杂的系统监控、事务管理、安全控制它们都是背后的核心机制。花时间掌握它们不仅能让你写出更优雅的代码更能让你对Spring框架的运行机制有更深的理解。记住好的工具要用在刀刃上精确的切点表达式和高效的JoinPoint信息处理就是你手中的利刃。 
长河君 · 2026/8/15 2:10:18 · 阅读 1.2k Spring AOP核心：JoinPoint与切点表达式实战精解
1. 项目概述为什么我们需要深入理解JoinPoint与切点表达式如果你正在用SpringBoot开发并且已经接触到了AOP面向切面编程那你大概率已经用过Before、After这样的注解了。但不知道你有没有遇到过这样的困惑在通知方法里除了打印个日志好像也不知道还能干点啥或者想精准地拦截某个特定包下、带有特定注解的方法时那个Pointcut表达式怎么写都觉得不对劲要么拦截多了要么漏掉了关键方法。我自己在带团队和做项目的过程中发现很多开发者对Spring AOP的使用停留在“依葫芦画瓢”的阶段。大家知道要加个Aspect注解知道几个通知类型但一旦涉及到从被拦截的方法里拿参数、拿返回值、甚至修改参数或者需要编写复杂的拦截规则时就有点抓瞎了。核心的症结往往在于两个东西没吃透一个是JoinPoint连接点对象它封装了当前拦截到的那个方法的所有信息是我们的“情报中心”另一个就是切点表达式它决定了我们的“狙击枪”到底瞄准哪里精度如何。JoinPoint和切点表达式是Spring AOP这座大厦的承重墙。JoinPoint让你在切面里“看得见”业务方法的内里而切点表达式则让你“指得准”要增强的目标。搞懂了它们你就能实现更优雅的日志记录、更灵活的权限校验、更强大的事务管理和性能监控而不是仅仅打印一句“方法执行了”。这篇文章我就结合自己踩过的坑和总结的最佳实践带你彻底搞明白这两个核心概念让你写的AOP代码既强大又精准。2. 核心基石JoinPoint对象全解与实战应用JoinPoint接口是AOP联盟定义的标准在Spring AOP中它代表程序执行过程中一个明确的点比如方法的调用或异常的抛出。在通知方法中我们可以通过声明一个JoinPoint类型的参数来获取这个点的所有上下文信息。这是切面能够干预业务逻辑的基础。2.1 JoinPoint的核心方法与信息提取JoinPoint提供了丰富的方法最常用的几个如下getSignature(): 获取连接点的签名返回一个Signature对象。这可能是我们最常用的方法因为它能告诉我们当前拦截的是什么。Signature.getDeclaringType(): 获取声明此方法的类Class对象。Signature.getName(): 获取方法名。Signature.toLongString()/toShortString(): 获取方法完整或简短的字符串表示包含类名、方法名、参数类型。getArgs(): 获取当前拦截方法的传入参数以一个Object[]数组返回。这是动态处理业务参数的关键。getTarget(): 获取被代理的目标对象即我们原本的Service/Controller实例。getThis(): 获取当前的AOP代理对象本身。在Spring AOP中这通常就是一个JDK动态代理或CGLIB代理对象。光看概念有点抽象我们直接看一个实战中的例子。假设我们有一个用户服务要记录所有服务方法的入参、出参和执行时间。Aspect Component public class ServiceLogAspect { private static final Logger log LoggerFactory.getLogger(ServiceLogAspect.class); Around(execution(* com.example.demo.service.*.*(..))) public Object logAround(ProceedingJoinPoint joinPoint) throws Throwable { // ProceedingJoinPoint是JoinPoint的子接口专用于Around通知多了proceed()方法。 String className joinPoint.getTarget().getClass().getSimpleName(); String methodName joinPoint.getSignature().getName(); Object[] args joinPoint.getArgs(); // 1. 记录入参 log.info([{}#{}] 方法开始执行入参: {}, className, methodName, Arrays.toString(args)); long startTime System.currentTimeMillis(); Object result null; try { // 执行目标方法 result joinPoint.proceed(); long elapsedTime System.currentTimeMillis() - startTime; // 2. 记录出参和执行时间 log.info([{}#{}] 方法执行成功耗时: {}ms结果: {}, className, methodName, elapsedTime, result); } catch (Exception e) { long elapsedTime System.currentTimeMillis() - startTime; // 3. 记录异常情况 log.error([{}#{}] 方法执行异常耗时: {}ms异常: {}, className, methodName, elapsedTime, e.getMessage(), e); throw e; // 异常要继续抛出保证业务逻辑感知 } return result; } }在这个例子里我们通过joinPoint.getTarget()拿到实际的服务类实例再取类名。通过joinPoint.getSignature().getName()拿到方法名。最关键的是joinPoint.getArgs()它让我们能把方法的参数记录到日志里。而joinPoint.proceed()则是Around通知的灵魂它代表继续执行原业务方法。注意直接使用Arrays.toString(args)记录参数在对象比较复杂时如包含循环引用可能导致栈溢出或日志过长。生产环境建议使用JSON序列化工具如Jackson的ObjectMapper并做长度截断或者只记录关键字段。2.2 ProceedingJoinPoint的进阶操控Around通知使用的是ProceedingJoinPoint它扩展了JoinPoint核心就是那个proceed()方法。这给了我们最大的操控权我们可以在执行目标方法前后做任何事甚至可以决定是否执行、如何执行目标方法以及修改它的返回值。场景一参数校验与修改假设我们希望对某些方法的字符串参数自动做Trim操作。Around(annotation(com.example.demo.annotation.AutoTrim)) public Object autoTrimParams(ProceedingJoinPoint pjp) throws Throwable { Object[] args pjp.getArgs(); for (int i 0; i args.length; i) { if (args[i] instanceof String) { args[i] ((String) args[i]).trim(); } // 还可以递归处理对象中的String字段这里简化 } // 使用修改后的参数数组继续执行 return pjp.proceed(args); }这里我们通过pjp.getArgs()拿到参数数组修改后再调用pjp.proceed(args)将修改后的参数传入。这是一个非常强大的特性但使用需谨慎避免破坏业务逻辑的预期。场景二缓存与快速返回实现一个简单的环绕缓存如果缓存命中则直接返回不执行目标方法。Around(execution(* com.example.demo.service.UserService.getUserById(Long)) args(userId)) public Object cacheUser(ProceedingJoinPoint pjp, Long userId) throws Throwable { String cacheKey user: userId; Object cachedValue cache.get(cacheKey); if (cachedValue ! null) { log.info(缓存命中key: {}, cacheKey); return cachedValue; // 直接返回不执行proceed() } log.info(缓存未命中执行查询key: {}, cacheKey); Object result pjp.proceed(); // 执行真实的数据库查询 cache.put(cacheKey, result, 5, TimeUnit.MINUTES); return result; }这个例子展示了Around通知可以根据条件缓存是否命中来决定是否调用proceed()。如果不调用则目标业务方法根本不会执行。实操心得Around功能最强但也最容易出错。务必在try-catch-finally块中妥善处理proceed()的调用和异常确保资源释放和事务边界正确。另外修改参数或返回值时一定要清楚对上下游业务的影响。3. 狙击枪的准星切点表达式语法精讲切点表达式决定了你的切面要“织入”到程序的哪些位置。Spring AOP主要使用AspectJ的切点表达式语言功能非常强大。表达式主要由指示器Designators和通配符组成。3.1 execution最常用的方法匹配指示器这是你几乎每天都会用到的指示器语法如下execution(modifiers-pattern? ret-type-pattern declaring-type-pattern?name-pattern(param-pattern) throws-pattern?)其中带?的是可选部分。ret-type-pattern: 返回值类型*代表任意类型。declaring-type-pattern: 方法所属的类名模式。name-pattern: 方法名模式。param-pattern: 参数模式这是最容易出错的地方。throws-pattern: 异常类型很少用。我们来看一些具体例子和解析表达式示例含义解析execution(public * *(..))匹配所有public方法。execution(* set*(..))匹配所有以“set”开头的方法。execution(* com.example.service.*.*(..))匹配com.example.service包下不含子包的任何类的任何方法。execution(* com.example.service..*.*(..))匹配com.example.service包及其所有子包下任何类的任何方法。两个点..代表当前包及子包这是关键。execution(* com.example.service.UserService.*(..))匹配UserService接口/类的所有方法。execution(* com.example.service.*Service.*(..))匹配包下以Service结尾的类的所有方法。execution(* com.example.service.UserService.save*(..))匹配UserService中所有以save开头的方法。execution(* *(java.lang.String, ..))匹配第一个参数是String后面可以有任意个任意类型参数的方法。execution(* *(org.springframework.web.bind.annotation.RequestBody (*), ..))匹配第一个参数被RequestBody注解修饰的方法需AspectJ完整支持Spring AOP可能受限。参数模式(param-pattern)详解(): 匹配无参数方法。(..): 匹配任意数量、任意类型的参数包括无参。最常用。(*): 匹配一个任意类型的参数。(*, String): 匹配两个参数第二个是String类型。(java.lang.Long, ..): 匹配第一个参数是Long后面跟任意参数。3.2 within, this, target, args 与 annotation除了execution还有其他指示器用于更精细或不同维度的匹配。within: 匹配指定类型内的方法。比execution在类级别上更简洁。within(com.example.service.UserService): 匹配UserService类的所有方法。within(com.example.service.*Service): 匹配包下以Service结尾的类的所有方法。within(org.springframework.stereotype.Service *): 匹配所有被Service注解的类的所有方法。这个非常实用thisvstarget: 这两个容易混淆。this(com.example.service.UserService):匹配代理对象AOP Proxy的类型是UserService或其子类。在JDK动态代理时代理对象实现接口所以this匹配接口。target(com.example.service.UserService):匹配目标对象被代理的实际对象的类型是UserService或其子类。通常我们更关心目标对象所以target更常用。简单记忆this看代理Proxytarget看目标Target。在CGLIB代理类代理时两者通常一致。args: 匹配运行时参数类型符合指定模式的方法。它与execution中的参数模式不同args更动态且可以将参数绑定到通知方法的参数上。Before(execution(* *..find*(..)) args(id,..))public void logFind(JoinPoint jp, Long id) { ... }这里args(id,..)不仅要求方法第一个参数是Long或可自动转换还将该参数值绑定到了通知方法的id参数上非常方便。annotation:这是我认为最优雅、侵入性最低的匹配方式。它匹配带有指定注解的方法。Pointcut(annotation(com.example.demo.annotation.OperateLog))public void operateLogPointcut() {}这样我只需要在需要记录操作日志的方法上加上OperateLog注解即可切点表达式变得非常清晰和聚焦。3.3 组合使用与运算符切点表达式可以通过逻辑运算符与、||或、!非进行组合实现复杂逻辑。// 组合示例记录Service层中非查询方法不以get/find开头的执行 Pointcut(within(org.springframework.stereotype.Service *)) public void serviceLayer() {} Pointcut(execution(* *..get*(..)) || execution(* *..find*(..))) public void queryOperation() {} Before(serviceLayer() !queryOperation()) public void logNonQuery(JoinPoint jp) { // 记录非查询操作 }注意事项切点表达式在应用启动时会被解析和优化。过于复杂的表达式尤其是大量使用||可能会轻微影响启动性能。建议将通用的切点定义为Pointcut方法然后通过方法名引用这样既清晰又可复用。4. 实战构建一个可复用的操作日志切面现在我们把JoinPoint和切点表达式结合起来实现一个生产级可用的操作日志切面。这个切面会记录谁、在什么时候、对什么数据、做了什么事情、结果如何。4.1 定义自定义注解与日志实体首先我们定义一个注解用于标记需要记录日志的方法。Target(ElementType.METHOD) Retention(RetentionPolicy.RUNTIME) public interface OperateLog { /** 业务模块 */ String module() default ; /** 操作类型如新增、删除、修改、查询 */ String type() default ; /** 操作描述支持SpEL表达式从方法参数中取值 */ String desc() default ; }然后定义一个日志实体用于存储和传递日志信息。Data public class OperateLogInfo { private String module; private String type; private String desc; private String operator; // 操作人从Session或Token中获取 private String method; private String params; private String result; private Boolean success; private String errorMsg; private Long costTime; private LocalDateTime operateTime; }4.2 实现切面逻辑核心切面实现如下这里我们使用Around通知因为它能完美控制方法执行前后并获取执行结果和耗时。Aspect Component Slf4j public class OperateLogAspect { Autowired private OperateLogService logService; // 假设有一个服务用于保存日志 Autowired private OperatorHolder operatorHolder; // 一个工具类用于获取当前登录用户 // 定义切点所有被OperateLog注解的方法 Pointcut(annotation(com.example.demo.annotation.OperateLog)) public void operateLogPointCut() {} Around(operateLogPointCut()) public Object around(ProceedingJoinPoint pjp) throws Throwable { OperateLogInfo logInfo new OperateLogInfo(); long startTime System.currentTimeMillis(); Object result null; boolean success true; String errorMsg null; try { // 1. 获取方法签名和注解信息 MethodSignature signature (MethodSignature) pjp.getSignature(); Method method signature.getMethod(); OperateLog operateLog method.getAnnotation(OperateLog.class); // 2. 解析SpEL表达式获取动态的操作描述 String desc parseSpEL(operateLog.desc(), method, pjp.getArgs()); // 3. 填充基础日志信息 logInfo.setModule(operateLog.module()); logInfo.setType(operateLog.type()); logInfo.setDesc(desc); logInfo.setMethod(pjp.getTarget().getClass().getName() # method.getName()); logInfo.setOperator(operatorHolder.getCurrentOperator()); // 获取操作人 logInfo.setParams(parseParams(pjp.getArgs())); // 将参数序列化为JSON字符串 // 4. 执行目标方法 result pjp.proceed(); logInfo.setResult(parseResult(result)); // 序列化结果注意脱敏 } catch (Throwable e) { success false; errorMsg e.getMessage(); throw e; // 异常继续抛出 } finally { // 5. 最终记录日志 long endTime System.currentTimeMillis(); logInfo.setCostTime(endTime - startTime); logInfo.setSuccess(success); logInfo.setErrorMsg(errorMsg); logInfo.setOperateTime(LocalDateTime.now()); // 异步保存日志避免影响主业务性能 CompletableFuture.runAsync(() - { try { logService.save(logInfo); } catch (Exception e) { log.error(保存操作日志失败, e); } }); } return result; } // 解析SpEL表达式的方法简化版实际需注入SpEL解析器 private String parseSpEL(String spEL, Method method, Object[] args) { if (StringUtils.isEmpty(spEL)) { return ; } // 这里需要实现SpEL解析逻辑将方法参数绑定到表达式上下文中 // 例如 desc “删除用户#{args[0]}” - “删除用户张三” // 具体实现略 return spEL; } private String parseParams(Object[] args) { // 使用Jackson等工具将args序列化为JSON注意过滤密码等敏感信息 try { return new ObjectMapper().writeValueAsString(args); } catch (JsonProcessingException e) { return 参数序列化失败; } } private String parseResult(Object result) { /* 类似parseParams */ } }4.3 在业务方法上使用最后在需要记录日志的业务方法上轻松地加上注解即可。Service public class UserServiceImpl implements UserService { Override OperateLog(module 用户管理, type 新增, desc 新增用户用户名#{args[0].username}) public User createUser(UserDTO userDTO) { // ... 业务逻辑 return user; } Override OperateLog(module 用户管理, type 删除, desc 删除用户用户ID#{args[0]}) public void deleteUser(Long userId) { // ... 业务逻辑 } }这个实战案例展示了如何将JoinPoint获取方法、参数、目标对象和基于注解的切点表达式annotation紧密结合构建出一个高内聚、低耦合、声明式的通用日志组件。通过SpEL表达式我们甚至能在注解中动态地引用方法参数让日志描述更加智能。5. 避坑指南与性能优化在实际项目中大规模使用AOP尤其是复杂的切点表达式和重量级的Around通知时会遇到不少坑。这里分享几个最常见的。5.1 常见问题排查问题1切面不生效这是新手最常遇到的问题。排查步骤检查切面类是否被Spring管理确保你的Aspect类上有Component或其它Spring Stereotype注解或者已经在配置类中通过Bean声明。检查切点表达式是否正确特别是包路径、方法名匹配。使用execution(* com.example..*.*(..))这样的宽泛表达式先测试再逐步收窄。检查目标方法是否被代理Spring AOP基于代理。对于同类内部方法调用即一个Service方法A调用了同一个Service的另一个方法B由于调用走的是this引用而非代理对象切面是不会生效的。这是最大的一个坑解决方案注入自身代理Autowired private MyService self;然后调用self.methodB()或者使用AspectJ的编译时/加载时织入LTW。检查EnableAspectJAutoProxy在Spring Boot中默认已启用。如果是纯Spring项目需要在配置类上加上此注解。问题2获取的参数或返回值是null或不对参数为null检查getArgs()返回的数组索引是否正确。注意args指示器绑定参数时通知方法参数名需与切点表达式中的绑定名一致或使用Before(pointcut() args(id))并指定参数Long id。返回值类型转换异常在AfterReturning中使用returning属性绑定的返回值其类型必须与通知方法参数类型兼容。如果目标方法返回Object而你用String去接会报错。问题3循环依赖如果切面AspectA依赖了ServiceB而ServiceB的方法又被AspectA切面拦截在Spring创建Bean时可能会形成循环依赖。Spring通常能处理Setter注入的循环依赖但构造函数注入可能会出问题。解决方案尽量避免在切面中注入会被自己拦截的Bean。如果必须考虑使用Lazy注解延迟注入或者将切面逻辑移到不会被拦截的工具类中。5.2 性能考量与最佳实践切点表达式尽量精确避免使用execution(* *..*.*(..))这种匹配所有方法的表达式。范围越大Spring在每次方法调用时判断是否要执行通知的成本就越高。尽量使用within()限定到特定包或使用annotation精确打击。通知方法本身要轻量尤其是在Around和Before中。如果通知方法里执行了数据库查询、远程调用等耗时操作会显著拖慢每个被拦截的业务方法。日志记录、权限校验等操作应考虑异步化如上面实战案例中使用CompletableFuture.runAsync。谨慎使用AroundAround功能最强但开销也最大。如果只是需要在方法执行前或后做一个简单动作如记录开始、清理资源优先考虑Before或After。避免在切点表达式中使用bean()指示器进行大量匹配bean(service*)虽然方便但Spring需要遍历所有Bean名称进行模式匹配在Bean很多时可能影响启动速度。使用编译时织入CTW或加载时织入LTW应对性能瓶颈Spring AOP的运行时代理JDK/CGLIB是有开销的。如果AOP成为性能瓶颈通常在高频方法调用时可以考虑使用AspectJ的CTW/LTW它直接在字节码层面进行织入没有代理开销。但配置更复杂且对“同类内部调用”问题也无能为力因为这是代码结构问题。5.3 设计模式建议单一职责一个切面只做一件事。不要在一个Aspect类里既做日志又做缓存又做事务。拆分成LoggingAspect、CachingAspect、TransactionalAspect等这样更清晰也便于管理和排序。使用Order或实现Ordered接口当多个切面作用于同一个连接点时执行顺序很重要。例如通常事务切面Transactional应该先于缓存切面执行。你可以用Order(1)注解来指定顺序数字越小优先级越高越先执行。拥抱注解驱动相比于在XML或Java Config中定义复杂的切点表达式使用自定义注解如OperateLog、CacheResult来标记需要被增强的方法是一种更声明式、更清晰、耦合度更低的方式。业务开发者只需要关心注解而不需要知道背后复杂的AOP配置。理解JoinPoint和切点表达式是解锁Spring AOP全部潜力的钥匙。从简单的日志记录到复杂的系统监控、事务管理、安全控制它们都是背后的核心机制。花时间掌握它们不仅能让你写出更优雅的代码更能让你对Spring框架的运行机制有更深的理解。记住好的工具要用在刀刃上精确的切点表达式和高效的JoinPoint信息处理就是你手中的利刃。