Java注解本质是继承自Annotation的接口,编译为字节码中的特殊接口,运行时通过动态代理提供属性访问;其生效依赖@Target、@Retention等元注解,仅@Retention(RUNTIME)可被反射读取,且需注意泛型擦除与类型匹配问题。

Java 注解本质上是**一种接口类型,由编译器识别并可被反射读取的元数据标记**。它不携带运行时逻辑,本身不执行任何代码,只是为类、方法、字段等程序元素“贴标签”,供工具、框架或运行时环境按需解析使用。
注解的底层本质是 interface
每个注解定义(如 @Override)在字节码中都被编译为一个继承自 java.lang.annotation.Annotation 的特殊接口。JVM 不会实例化它,而是通过反射返回一个动态代理对象 —— 这就是为什么你不能 new 一个注解,也不能在注解上写方法实现。
-
@interface不是语法糖,而是 JVM 规范强制支持的接口声明形式 - 注解的属性(如
value()、name())实际是接口中的抽象方法 - 当你写
@Deprecated(since="1.8"),JVM 在反射时通过代理对象把since()方法调用转为对应字符串值
注解必须配合元注解才能生效
光定义注解没用,它的生命周期、作用目标、是否可重复,全靠四个标准元注解控制:
-
@Target:限定能用在哪(ElementType.METHOD、ElementType.TYPE等),否则编译报错java.lang.annotation.AnnotationFormatError -
@Retention:决定保留到哪一阶段 ——SOURCE(仅源码)、CLASS(默认,进 class 文件但不进 JVM)、RUNTIME(唯一能被反射读取的) -
@Documented:影响 Javadoc 是否包含该注解说明 -
@Repeatable:允许同一位置写多个同名注解(需配套容器注解)
反射读取注解时容易忽略的关键点
不是所有注解都能被 getAnnotations() 拿到 —— 它只返回 @Retention(RUNTIME) 的注解,且默认不递归查找父类/接口上的注解。
立即学习“Java免费学习笔记(深入)”;
- 要查继承来的注解,得用
getDeclaredAnnotations()+ 手动遍历父类,或用 Spring 的AnnotationUtils.findAnnotation() - 泛型类型擦除会影响注解读取:如果注解标在带泛型的方法返回值上(如
List),反射拿到的是List,原始泛型信息已丢失 - 注解属性值如果是数组、枚举、Class 或其他注解,反射获取时需注意类型匹配,比如
annotation.value()返回Class[],不能直接强转成String[]
真正难的不是写注解,而是设计它的保留策略和反射边界 —— 很多性能问题(比如高频反射扫描注解)和 ClassLoader 隔离问题(如 Spring Boot 的 devtools 下注解失效),都源于对 @Retention 和类加载时机的理解偏差。










