Java注解本质是继承Annotation的接口,由APT或反射处理,其行为取决于元注解:@Target限定位置,@Retention决定生命周期(SOURCE/CLASS/RUNTIME),仅RUNTIME可反射获取。

Java注解不是语法糖,也不是运行时自动生效的“魔法”,它的行为完全取决于谁在什么时候处理它。核心就两点:编译期靠APT(或javac插件)解析,运行期靠反射读取;而注解本身只是个带元数据的接口,不执行任何逻辑。
注解的本质是接口,不是类
每个用 @interface 声明的注解,编译后都是一个继承自 java.lang.annotation.Annotation 的接口。反编译后能看到类似:
public interface MyAnnotation extends java.lang.annotation.Annotation { ... }
它没有实现类,JVM在运行时通过动态代理生成临时实现对象——也就是说,你拿到的注解实例,其实是JDK用Proxy动态创建的代理对象,不是你写的源码直接new出来的。
立即学习“Java免费学习笔记(深入)”;
这解释了为什么不能在注解里写方法体、不能有静态字段、所有元素必须有默认值:因为它是接口,不是类。
@Target、@Retention这些元注解到底管什么
元注解是“描述注解的注解”,它们不参与业务逻辑,只告诉编译器和JVM怎么对待这个注解:
- @Target:限定能加在哪儿。比如 ElementType.METHOD 表示只能标在方法上;如果标在类上会编译报错
- @Retention:决定生命周期。取值为 SOURCE(仅源码期,如@Override)、CLASS(编译进字节码但不加载到JVM)、RUNTIME(可被反射读取)
- @Documented:影响Javadoc生成,加了它,该注解会出现在API文档里
- @Inherited:仅对类注解有效,表示子类可继承父类上的该注解(注意:方法/字段注解不继承)
面试常问:为什么 @Override 的 @Retention 是 SOURCE? 因为它只用于编译期检查重写是否合法,运行时根本不需要,留着反而占字节码空间。
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
编译期处理 vs 运行期处理:性能与时机的关键分水岭
注解要不要在运行时反射读取,直接影响性能和设计选择:
- 编译期处理(APT):在 javac 编译阶段触发,通过 javax.annotation.processing.Processor 扫描并生成新代码(如ButterKnife旧版、Lombok、MapStruct)。优势是零运行时开销,缺点是无法处理泛型擦除后的类型信息
- 运行期处理(Reflection):通过 Class.getAnnotation() 或 Method.getAnnotation() 获取。Spring的 @Autowired、JUnit的 @Test 都走这条路。但每次反射都有性能成本,尤其高频调用场景要谨慎
典型陷阱题:如果一个注解的 @Retention 是 CLASS,能否用反射获取? 不能。只有 RUNTIME 级别才支持反射读取;CLASS 级别只保留在 .class 文件里,JVM加载类时不加载该注解。
自定义注解 + 反射解析的最小可行实践
写一个能真正起作用的注解,三步缺一不可:
- 定义注解:加上 @Retention(RetentionPolicy.RUNTIME) 和合适的 @Target
- 在目标类/方法上使用它
- 写解析逻辑:用反射获取注解,并根据其属性做实际操作(比如打印日志、修改行为、抛异常等)
例如,一个简单日志注解:
@Target(ElementType.METHOD)
@Retention(RetentionPolicy.RUNTIME)
public @interface LogExecutionTime {}
解析时:
if (method.isAnnotationPresent(LogExecutionTime.class)) {
System.out.println("Executing: " + method.getName());
}
注意:没加 RUNTIME,这段反射代码永远拿不到注解;没加 @Target(METHOD),编译器就不允许你把它标在字段上。

















