要让 Spring AOP 拦截被自定义注解标记的方法，需满足三步：注解必须声明 @Retention(RetentionPolicy.RUNTIME) 且指定 @Target；切面用 @annotation(全限定名) 定义切入点并添加 @Aspect 和 @Component；目标方法须为 Spring 管理的 Bean 且调用经过代理，不可用 this 直接调用。
要让 Spring AOP 拦截被自定义注解标记的方法，关键不是“写个注解就行”，而是三步协同：注解能被运行时读取、切面能精准识别它、目标方法调用必须走 Spring 代理。
注解必须保留到运行时
注解默认编译后就没了，AOP 在运行期靠反射找注解，所以 @Retention(RetentionPolicy.RUNTIME) 不可省略。同时明确作用位置，比如只用于方法：
- @Target(ElementType.METHOD)
- @Retention(RetentionPolicy.RUNTIME)
- @Documented（可选，方便生成文档）
如果希望类上加注解就生效（比如整个 Controller 都需日志），可加上 ElementType.TYPE。
切面要正确定义切入点表达式
Spring AOP 通过 @annotation(全限定名) 匹配方法。注意两点：
立即学习“Java免费学习笔记（深入）”；
JavaStoryDevelop
下载
你接手一个需求时，是不是经常这样："改一个小字段 → 结果把不相关的代码也改了"、"需求说得很模糊 → 做着做着发现跑偏了"、"数据库加个字段 → 上线才发现漏了数据兼容"、"做了个新功能 → 一个月后自己都忘了当时怎么设计的"、"写到一半被中断 → 再回来不知道从哪继续"；这个 Skill 就是专门解决这些问题的。 它会自动探测你的项目环境（JDK、Spring Boot、ORM、数据库、前端框架），记在
- 表达式里写的是注解的完整类名，例如 @annotation(com.example.MyLog)
- 切面类必须加 @Aspect 和 @Component（或手动注册为 Bean），否则 Spring 不会识别它
推荐用命名 pointcut 提升可读性：
@Pointcut("@annotation(com.example.MyLog)")
public void myLogPointcut() {}
@Around("myLogPointcut()")
public Object logAround(ProceedingJoinPoint joinPoint) throws Throwable { ... }
目标方法必须由 Spring 管理且调用经过代理
这是最容易出错的地方：
- 被拦截的方法必须在 Spring 容器里的 Bean 中（如 @Service、@Controller 类里）
- 不能是 this.xxx() 这种内部直接调用——它绕过了代理，AOP 失效；必须是其他 Bean 调用它，或本类方法被注入自身（通过 @Autowired 注入自己）
- 确保项目引入了 spring-boot-starter-aop 依赖
获取注解属性值也很简单
通知方法签名中可以直接声明注解类型参数，Spring 会自动注入对应注解实例：
@Before("@annotation(myLog)")
public void before(JoinPoint jp, MyLog myLog) {
System.out.println("value = " + myLog.value());
System.out.println("level = " + myLog.level());
}
这样就能根据注解的不同属性值执行差异化逻辑，比如不同日志级别、不同缓存策略等。
