Spring AOP 切点设计实战：execution vs @annotation
一、前言
在学习 Spring AOP 时，很多人最先接触的是：
@Around("execution(* com.xxx.service..*(..))")但随着项目复杂度提升，你会开始看到另一种写法：
@Around("@annotation(operationLog)")这时候就会产生一个非常典型的疑问：
❗ execution 和 @annotation 到底有什么区别？是不是重复了？
如果你只是停留在“语法层”，你会觉得：
只是两种写法而已但如果从工程角度看，这其实是一个非常关键的设计问题。
二、核心结论（先给答案）
先记住这一句：
execution = 按“代码位置”拦截（全局） @annotation = 按“标记”拦截（精确）企业项目中，真正的用法是：
execution + @annotation 组合使用三、execution：按“代码位置”拦截
1. 基本写法
@Around("execution(* com.xxx.modules..controller..*(..))")2. 含义拆解
execution( * 任意返回值 com.xxx.modules 指定包 .. 子包 controller.. controller 层 *.* 所有类的所有方法 (..) 任意参数 )👉 本质：
按“包路径”拦截3. 适合场景
✔ 请求日志（所有接口都要记录） ✔ 统一监控 ✔ 全局增强4. 举例
@Around("execution(* com.xxx.modules..controller..*(..))") public Object log(ProceedingJoinPoint joinPoint) { // 所有接口都会进来 }四、@annotation：按“标记”拦截
1. 基本写法
@Around("@annotation(operationLog)")2. 含义
只拦截“带某个注解的方法”3. 使用方式
第一步：定义注解
@Target(ElementType.METHOD) @Retention(RetentionPolicy.RUNTIME) public @interface OperationLog { String module() default ""; String action() default ""; }第二步：标记方法
@OperationLog(module = "用户模块", action = "创建用户") @PostMapping("/create") public Result<Void> createUser() { return Result.success(); }第三步：AOP 拦截
@Around("@annotation(operationLog)") public Object operationLog(ProceedingJoinPoint joinPoint, OperationLog operationLog) throws Throwable { log.info("操作日志：module={}, action={}", operationLog.module(), operationLog.action()); return joinPoint.proceed(); }👉 本质：
按“标记”拦截五、为什么 execution 不够用（关键）
假设有一个 Controller：
20 个接口但真正需要记录“操作日志”的只有：
创建用户 删除用户 支付 退款❌ 如果用 execution
@Around("execution(* com.xxx.modules.user.controller..*(..))")结果：
20 个接口全部被拦截 ❌✅ 正确做法：@annotation
@OperationLog(...)👉 只给关键接口打标记：
精准控制六、企业项目的真实用法（重点）
实际项目不会只用一种，而是组合：
1️⃣ 请求日志（全局）
@Around("execution(* com.xxx.modules..controller..*(..))")👉 所有接口都记录日志
2️⃣ 操作日志（关键接口）
@Around("@annotation(operationLog)")👉 只记录关键操作
3️⃣ 权限控制
@Around("@annotation(checkPermission)")4️⃣ 限流
@Around("@annotation(rateLimit)")👉 总结：
execution → 全局能力 @annotation → 精细控制七、组合写法（面试加分）
你甚至可以组合：
@Around("execution(* com.xxx.modules..controller..*(..)) && @annotation(operationLog)")含义：
只拦 controller 层 + 且带注解的方法八、设计思路总结（最重要）
execution = 扫一片（全拦） @annotation = 点名（精确） 企业项目 = execution + @annotation 组合九、常见误区
❌ 误区1：只会 execution
所有接口都被拦 无法精细控制❌ 误区2：只用 @annotation
每个接口都要加注解 维护成本高❌ 误区3：不区分场景
日志、权限、限流全部混在一起十、面试怎么说（直接可用）
如果面试官问：
你项目里 AOP 怎么用的？可以这样回答：
我在项目中区分了两种切点方式。
execution 主要用于全局能力，比如请求日志，我会在 controller 层统一拦截所有接口。
@annotation 主要用于精细控制，比如操作日志、权限校验、限流，我会通过自定义注解标记关键接口，然后通过 AOP 进行拦截。
在实际项目中，我是将 execution 和 @annotation 组合使用，从而实现全局能力和精细控制的统一。
十一、总结
这篇文章最核心的不是语法，而是设计思路：
AOP 的价值，不是“能拦截”，而是“如何优雅地控制拦截范围”最终你要做到的是：
全局能力 → execution 关键能力 → @annotation 工程落地 → 两者组合十二、延伸
如果你已经看完前几篇：
Spring AOP 从原理到实战（结合事务彻底搞懂）
Spring AOP 进阶实战：从日志到权限/链路追踪/限流（真正企业用法）
Spring Boot 工程化进阶：统一返回 + 全局异常 + AOP 通用工具包
AOP 原理 AOP 工程化 统一返回 + 异常处理那么这一篇补齐的是：
AOP 切点设计能力这一步非常关键，因为：
从“会用 AOP” 到“会设计 AOP”这就是中级工程师的分水岭。