java注解的处理时机取决于@retention策略:source仅用于编译期检查(如@override),class供字节码工具处理(如lombok),runtime支持运行时反射调用(如spring、junit)。

Java 注解的处理时机(编译期 vs 运行期)关键看 @Retention 的保留策略,再结合实际使用场景来记——不是死背,而是按“谁在什么时候用它”来理解。
看 @Retention 策略定生命周期
注解本身不会自动生效,它的“存活时间”由 @Retention 决定:
-
@Retention(RetentionPolicy.SOURCE):只在源码阶段存在,编译完就丢掉。比如
@Override、@SuppressWarnings,javac 用完即弃,class 文件里没有。 - @Retention(RetentionPolicy.CLASS):保留在 class 文件中,但 JVM 加载时不进内存。极少手动写,像某些字节码增强工具(如 lombok 编译期插件)会读取这类注解做修改。
-
@Retention(RetentionPolicy.RUNTIME):完整保留到运行期,可通过反射获取。这是最常用的一类,比如
@RequestMapping、@Test、自定义的校验注解。
编译期处理:靠注解处理器(APT)
想在编译时生成代码或校验逻辑,得写 AnnotationProcessor(继承 AbstractProcessor),并配合 @SupportedAnnotationTypes 声明支持哪些注解。
你接手一个需求时,是不是经常这样:"改一个小字段 → 结果把不相关的代码也改了"、"需求说得很模糊 → 做着做着发现跑偏了"、"数据库加个字段 → 上线才发现漏了数据兼容"、"做了个新功能 → 一个月后自己都忘了当时怎么设计的"、"写到一半被中断 → 再回来不知道从哪继续";这个 Skill 就是专门解决这些问题的。 它会自动探测你的项目环境(JDK、Spring Boot、ORM、数据库、前端框架),记在
- 典型例子:Lombok 的
@Data、@Builder就是靠 APT 在编译时注入 getter/setter/构造器等字节码。 - 注意:必须显式开启(如 Maven 中配置
maven-compiler-plugin的annotationProcessorPaths),否则不会触发。 - IDE 需要启用 “Enable annotation processing”,否则看不到生成的代码。
运行期处理:靠反射 + @Retention(RUNTIME)
只要注解声明为 RUNTIME,就能在运行时用 Class.getAnnotation() 或 Method.getAnnotation() 拿到它。
- Spring 的
@Autowired、@Value是 IOC 容器启动时扫描并处理的; - JUnit5 的
@Test是测试框架在执行前通过反射识别方法并调度; - 自己写校验框架(如基于
@NotNull)也是在方法调用前反射读取参数上的注解,再判断是否合法。
别混淆“处理时机”和“注解位置”
@Target(如 @Target({ElementType.METHOD, ElementType.TYPE}))只决定能写在哪,不影响何时处理。一个 @Target(METHOD) + @Retention(RUNTIME) 的注解,照样可以在运行期被反射读取;而 @Target(TYPE) + @Retention(SOURCE) 的注解,哪怕标在类上,也只活到编译结束。
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南










