只有加了 @retention(retentionpolicy.runtime) 的注解才能在运行时被反射读取，因其信息被写入 class 文件的 runtimevisibleannotations 属性，并由 jvm 加载到元空间供反射 api 直接访问；source 级注解编译后消失，class 级注解不加载进运行时内存。
只有加了 @Retention(RetentionPolicy.RUNTIME) 的注解，才能在运行时被反射读取。这是因为 JVM 在类加载阶段，会把 RUNTIME 级注解的信息一并加载进元空间（Metaspace），反射 API 才能从 Class、Method、Field 等对象中访问到它们。
RUNTIME 注解如何进入运行时内存
RUNTIME 策略会让注解字面量写入 class 文件的 RuntimeVisibleAnnotations 属性；类加载器加载该类时，JVM 解析这部分信息，并存入类的元数据结构中。后续调用 getAnnotation() 或 isAnnotationPresent() 时，反射机制就直接从元数据里查，而不是重新解析字节码。
- SOURCE 级注解：只存在于源码，编译后彻底消失，class 文件里找不到
- CLASS 级注解：写进 class 文件（出现在 RuntimeInvisibleAnnotations），但 JVM 不加载进运行时内存，反射拿不到
- RUNTIME 级注解：随类元数据一起驻留元空间，全程对反射开放
反射读取 RUNTIME 注解的必要条件
光有 @Retention(RetentionPolicy.RUNTIME) 还不够，还需满足几个操作前提：
- 注解必须实际标注在目标元素上（比如方法、字段或类），且包名、类名拼写完全正确
- 获取注解时要调用对应层级的反射方法：
clazz.getAnnotation()、method.getAnnotation()、field.getAnnotation() - 私有成员需先调用
setAccessible(true)，否则因访问控制被拦截 - 父类方法上的注解不会自动出现在子类重写的方法上；
@Inherited只对类级注解生效，对方法无效
验证注解是否真能被反射读取
不能只看代码写了 @Retention(RUNTIME)，得实测确认：
- 用
javap -v YourClass.class搜索 RuntimeVisibleAnnotations 和你的注解全限定名（如Lcom/example/MyAnno;） - 写测试代码，调用
method.getAnnotation(MyAnno.class)，检查是否返回非 null 实例 - 确保运行时 ClassLoader 能加载到注解类本身（避免模块隔离、双亲委派导致类不可见）
RUNTIME 支持的真实业务逻辑场景
几乎所有需要“运行时动态决策”的功能都依赖它：
- 权限控制：如
@RequireRole("ADMIN")，拦截器读取后校验当前用户角色 - 自动埋点：如
@LogExecutionTime，AOP 在方法执行前后计时并记录日志 - 参数校验：如
@NotNull，Controller 方法入参前检查字段是否为空 - 缓存开关：如
@Cacheable(enabled = true)，决定是否跳过数据库直查缓存
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
