要让 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(全限定名) 匹配方法。注意两点:
- 表达式里写的是注解的完整类名,例如 @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());
}
这样就能根据注解的不同属性值执行差异化逻辑,比如不同日志级别、不同缓存策略等。
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南











