Java运行时注解需用@Retention(RetentionPolicy.RUNTIME)才能被反射读取,配合反射与动态代理实现事务、权限等逻辑;自定义时须同时满足定义、标记、处理三要素。

Java注解在运行时的作用,就是作为“可被反射读取的元数据”,触发动态逻辑——它本身不执行任何代码,但配合反射+代理,就能实现事务、权限校验、自动注入等关键能力。
为什么必须用 @Retention(RetentionPolicy.RUNTIME) 才能运行时生效
不是所有注解都能活到程序跑起来那一刻。只有明确声明为 RUNTIME 的注解,JVM 才会把它保留在字节码里,并加载进运行时类信息中,供 Class.getAnnotation() 或 Method.getAnnotation() 拿到。
- 漏加
@Retention(RetentionPolicy.RUNTIME)是最常见错误:注解写了,反射却返回null,查半天发现只是“贴了张便利贴,但没让它活到开大会那天” -
@Retention(RetentionPolicy.CLASS)(默认)只存进.class文件,JVM 不加载;SOURCE连 class 都不进,编译完就丢 - Spring 的
@Transactional、MyBatis 的@Select、JUnit5 的@Test全部依赖这个保留策略
运行时注解靠什么干活?反射 + 动态代理是标配组合
注解自己不会动,真正干活的是你写的处理逻辑——而主流框架几乎都走“反射扫描 + 代理拦截”这条路:
- 先用反射遍历所有带注解的方法,比如
clazz.getDeclaredMethods()→method.isAnnotationPresent(MyTransactional.class) - 再用 JDK 动态代理或 CGLIB,在目标方法调用前后插入逻辑(如开启事务、捕获异常、回滚)
- Spring AOP 就是典型:你写个
@Transactional,实际执行的是代理对象的invoke(),不是你原方法本身 - 直接在业务方法里手写反射读注解也能行,但别这么做——耦合高、难复用、绕过框架生命周期
自定义运行时注解三步不能少:定义、标记、处理
想让自己的注解在运行时起作用,光写个 @interface 不够,缺一不可:
立即学习“Java免费学习笔记(深入)”;
@Target(ElementType.METHOD)
@Retention(RetentionPolicy.RUNTIME) // ← 必须有
public @interface LogExecutionTime {
String value() default "default";
}
- 定义时必须配齐
@Target(能贴在哪)和@Retention(RetentionPolicy.RUNTIME)(能活多久) - 使用时贴在方法/类上,比如
@LogExecutionTime("user-service") public void updateUser() { ... } - 处理逻辑得你自己写:要么注册一个 Spring
@Aspect切面,要么在启动时用反射扫描并注册回调,否则注解就是死的 - 别指望 JVM 或 javac 自动帮你执行——没有处理器,注解永远只是个标签
最容易被忽略的一点:运行时注解的价值不在“标记”,而在“谁来读、怎么用”。很多人卡在反射拿不到注解,其实问题不在注解定义,而在没确认类加载器是否一致、是否用了字节码增强工具(如 Lombok)干扰了原始类结构,或者代理层级太深导致反射拿到的是代理类而非目标类。










