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 声明支持哪些注解。
Java Maven 项目审查工作流的通用输入处理。当 Java Maven 项目以 ZIP压缩包或 GitLab 仓库 URL 形式提供且需要...时使用。
- 典型例子:Lombok 的
@Data、@Builder就是靠 APT 在编译时注入 getter/setter/构造器等字节码。 - 注意:必须显式开启(如 Maven 中配置
maven-compiler-plugin的annotationProcessorPaths),否则不会触发。 - IDE 需要启用 “Enable annotation processing”,否则看不到生成的代码。
运行期处理:靠反射 + @Retention(RUNTIME)
只要注解声明为 RUNTIME,就能在运行时用 Class.getAnnotation() 或 Method.getAnnotation() 拿到它。
立即学习“Java免费学习笔记(深入)”;
- Spring 的
@Autowired、@Value是 IOC 容器启动时扫描并处理的; - JUnit5 的
@Test是测试框架在执行前通过反射识别方法并调度; - 自己写校验框架(如基于
@NotNull)也是在方法调用前反射读取参数上的注解,再判断是否合法。
别混淆“处理时机”和“注解位置”
@Target(如 @Target({ElementType.METHOD, ElementType.TYPE}))只决定能写在哪,不影响何时处理。一个 @Target(METHOD) + @Retention(RUNTIME) 的注解,照样可以在运行期被反射读取;而 @Target(TYPE) + @Retention(SOURCE) 的注解,哪怕标在类上,也只活到编译结束。

















