Java注解在编译期由javac严格解析并写入字节码,运行时反射仅读取JVM预解析缓存;@Retention决定注解是否进入字节码及加载时机,校验发生在AST构建后、字节码生成前。

Java 注解不是运行时“动态扫描”出来的,它的存在、可见性与可读性,从你写完 @MyAnnotation 那一刻起,就由编译器在解析和生成字节码的两个关键阶段严格决定。
编译器怎么解析注解:词法 → 语法 → 符号表 → 校验
javac 在编译 .java 文件时,并不会跳过注解——它把注解当作语法结构的一部分来处理:
-
词法分析阶段:
@Override、@MyApi(path="/user")这样的写法被识别为特殊标记(Token),比如AT,IDENTIFIER,LPAREN,STRING_LITERAL等; - 语法分析阶段:这些 Token 被组织进抽象语法树(AST),注解节点作为修饰符(Modifier)挂在类、方法或字段节点上;
-
填充符号表后:编译器开始校验元注解规则:
-
@Target(ElementType.METHOD)→ 若你把@MyApi写在字段上,编译直接报错,不生成.class; -
@Retention(RetentionPolicy.RUNTIME)→ 决定是否把该注解写入字节码的RuntimeVisibleAnnotations属性; -
@Documented→ 影响 Javadoc 工具是否把注解名纳入生成文档; -
@Inherited→ 在字节码中设置ACC_ANNOTATION标志,影响子类继承逻辑(仅对类级别注解生效)。
-
这个过程发生在源码到 AST 的语义检查期,不依赖反射,也不等到运行时。
字节码里注解是怎么存的:属性表 + 结构化数据
编译通过后,注解信息不会变成 Java 代码,而是以结构化元数据形式写入 .class 文件的 attributes 区域:
-
RuntimeVisibleAnnotations:存放所有@Retention(RUNTIME)注解; -
RuntimeInvisibleAnnotations:存放@Retention(CLASS)注解(如 Lombok 的@Data); - 每条记录包含:
- 注解类型全限定名(如
Lcom/example/MyApi;); - 各属性名与值(
path→"/user",method→"GET"),已按 JVM 规范序列化为常量池索引; - 不是字符串拼接,也不是 JSON,是二进制编码的 annotation structure。
- 注解类型全限定名(如
你可以用 javap -v MyClass.class 查看,会看到类似:
FilePond 是一个 JavaScript 文件上传库,支持通过拖拽、粘贴和 API 方式处理文件、目录、URL 和 Data URI。它包含内置的图像优化功能、异步分块上传功能,并提供了适用于 React、Vue、Angular 和 Svelte 的适配器。
RuntimeVisibleAnnotations: 0: #27(#28=s#29) // 对应 @MyApi(path = "/user")
这说明:注解早已固化在字节码里,JVM 加载类时会把这部分解析进内存,供反射调用。
反射读取注解,其实只是查缓存
当你写 method.getAnnotation(MyApi.class):
- JVM 并不重新打开
.class文件、也不反向解析字节码; - 它直接从
Method对象关联的AnnotationData中取出类加载时就解析好的结果; - 这个
AnnotationData是懒加载的:第一次调用getAnnotation()时,JVM 才从RuntimeVisibleAnnotations表中反序列化出 Java 对象; - 后续调用全部走缓存,开销极小。
所以 @Retention(RUNTIME) 是反射可用的必要条件,但不是每次调用都“重新解析”。
总结关键点
- 注解校验发生在编译早期(AST 构建后、字节码生成前),越界直接编译失败;
- 注解是否进字节码,由
@Retention决定:SOURCE不进,CLASS进但不加载,RUNTIME进且加载; - 字节码中注解是紧凑的二进制结构,不是源码文本;
- 反射获取注解 = 查 JVM 预解析缓存,不是实时解析 class 文件;
- 注解本身是接口,编译器生成桥接实现,但你永远不能
new @MyApi()或继承它。
不复杂但容易忽略。
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南










