切点匹配连接点签名特征而非类名或方法名字符串，Spring AOP仅支持方法级连接点，@Pointcut描述哪些方法执行时触发通知。
Spring AOP里切点（Pointcut）到底匹配什么？
切点不是“匹配类名”或“匹配方法名字符串”，而是匹配连接点（Join Point）的签名特征，比如方法执行时的修饰符、返回类型、类路径、参数类型、异常声明等。Spring AOP只支持方法级别的连接点，所以@Pointcut本质上是在描述“哪些方法执行时触发通知”。
常见误写：@Pointcut("execution(* com.example.service.*.*(..))") 看似正确，但若目标类没被 Spring 容器管理（比如 new 出来的对象），AOP 根本不生效——切点语法对，代理没织入，照样不触发。
- 必须确保目标 bean 是 Spring 容器创建的（
@Service、@Component等声明 + 正确扫描） -
execution()中的包路径要和实际编译后的字节码路径一致（注意内部类会生成$符号，如Outer$Inner） - 使用
args()或@args时，参数类型必须精确匹配，不能靠自动装箱/拆箱隐式转换（例如int和Integer视为不同）
@Around 通知里为什么必须调用 proceed()？
@Around 是唯一能控制目标方法是否执行、何时执行、甚至替换返回值的通知类型。它接收一个 ProceedingJoinPoint 参数，而 proceed() 就是真正触发原方法执行的“开关”。不调用它，目标方法永远不会运行——这不是 bug，是设计使然。
典型错误：在异常处理逻辑中漏掉 finally 块里的 proceed()，或者在条件分支里只在 if 分支中调用，else 分支直接 return，导致部分调用被静默拦截。
- 必须显式调用
joinPoint.proceed()，否则目标方法跳过 - 可以传入新参数调用
proceed(Object[] args)，实现参数改写 - 捕获异常后可重新抛出、包装或吞掉，但要注意事务传播行为（如
@Transactional方法被 around 拦截后异常未抛出，事务可能不会回滚）
@Around("serviceMethod()")
public Object logExecutionTime(ProceedingJoinPoint joinPoint) throws Throwable {
long start = System.currentTimeMillis();
try {
Object result = joinPoint.proceed(); // ⚠️ 缺少这行，业务方法根本不会执行
long duration = System.currentTimeMillis() - start;
log.info("{} executed in {}ms", joinPoint.getSignature(), duration);
return result;
} catch (Exception e) {
log.error("Exception in {}", joinPoint.getSignature(), e);
throw e; // 不重新抛出，上层感知不到异常
}
}切面（Aspect）的优先级怎么控制才可靠？
多个切面作用于同一连接点时，执行顺序由 @Order 或 Ordered 接口决定，数值越小优先级越高。但要注意：@Order 只对同一个代理对象内的通知有效；如果切面横跨不同代理机制（比如 CGLIB 代理的类 vs JDK 动态代理的接口），顺序可能不可控。
更隐蔽的问题是：@Before 和 @AfterReturning 看似“前后”，但若目标方法抛异常，@AfterReturning 根本不执行——这时候你以为的“后置”其实不存在。
- 不要依赖
@Before+@AfterReturning组合做资源清理，改用@After（总会执行）或@AfterThrowing -
@Order(1)和@Order(2)能保证同一切面内通知顺序，但无法约束不同配置类中切面的加载顺序（需配合@Configuration的@DependsOn或明确 import 顺序） - 事务切面（
TransactionInterceptor）默认优先级是Ordered.LOWEST_PRECEDENCE - 100，自定义切面若想包裹事务逻辑（如测时），应设更低数值（如@Order(Ordered.LOWEST_PRECEDENCE - 200)）
为什么有些方法加了注解，切面却不生效？
最常见原因是调用发生在同一个类内部
。Spring AOP 基于代理，只有通过代理对象发起的调用才会被拦截。类内直接 this.method() 是 JVM 直接调用，绕过了代理。
另一个高频坑是：切点表达式用了 @annotation(com.example.Log)，但注解没加 @Retention(RetentionPolicy.RUNTIME)，导致运行时反射取不到注解信息。
- 检查注解是否带
@Retention(RetentionPolicy.RUNTIME)和@Target({ElementType.METHOD}) - 避免 self-invocation：把需要 AOP 的方法抽到另一个
@Service类中，或用AopContext.currentProxy()（需开启expose-proxy="true"） - 确认切面类本身被 Spring 扫描到（有
@Component或显式@Bean注册），且没有被@ConditionalOnMissingBean等条件排除
切点表达式看着像正则，实则是 AspectJ 的静态匹配逻辑；通知的执行时机取决于代理对象如何被调用；而切面的生效边界，往往卡在 Spring 容器生命周期和代理机制的夹缝里——这些地方不画调试断点，光看日志很难定位。
