Java注解需用@Retention(RetentionPolicy.RUNTIME)才能在运行时通过反射读取；否则默认CLASS或SOURCE策略下注解不可见。获取时须注意@Target匹配、参数注解用getParameterAnnotations()、重复注解用getAnnotationsByType()而非getAnnotation()，并安全处理默认值与ProGuard影响。
Java注解在运行时怎么被读取到？
必须用 @Retention(RetentionPolicy.RUNTIME)，否则反射拿不到。默认是 CLASS，编译后就丢弃了，RetentionPolicy.SOURCE 连 class 文件都不进。
常见错误：写了注解但 getAnnotation(...) 总返回 null，八成是忘了加 @Retention(RUNTIME) 或写在了方法参数上（参数注解要用 getParameterAnnotations()，且需 @Target(ElementType.PARAMETER)）。
实操建议：
- 所有要反射读取的注解，开头必须显式声明
@Retention(RetentionPolicy.RUNTIME) - 检查
@Target是否匹配使用位置（如ElementType.METHOD不能标在类上） - 接口上的注解默认不可继承，若需子类/实现类继承，得加
@Inherited（仅对CLASS和RUNTIME生效，且只作用于类）
如何安全地用反射获取注解值？
别直接调 annotation.value() —— 如果注解没设默认值、又没在代码里显式写出来，会抛 java.lang.annotation.IncompleteAnnotationException。
立即学习“Java免费学习笔记（深入）”；
更稳妥的方式是先用 isAnnotationPresent(...) 判定存在性，再用 getAnnotation(...) 获取；取属性值时，优先用 invoke() + getDefaultValue() 做兜底，或直接用 AnnotationUtils（Spring）这类工具类。
示例：手动兼容默认值
Object value = null;
Method method = annotation.getClass().getMethod("value");
if (method.getDefaultValue() != null) {
value = method.getDefaultValue();
} else {
value = method.invoke(annotation);
}
注解处理器（APT）和运行时反射有什么区别？
APT 在编译期工作，生成新源码（比如 @Override 不触发 APT，但 @Data（Lombok）或 @Mapper（MyBatis）会）；反射在 JVM 运行时查，不生成代码，但有性能开销和安全性限制（如模块系统下可能被 Module.addOpens 卡住）。
关键差异：
- APT 无法读取运行时才决定的值（比如依赖注入后的对象），反射可以
- 反射无法修改注解内容（注解实例是只读的），APT 可以生成任意逻辑
- Android 上反射读注解受 ProGuard 影响大，APT 生成的代码更稳定
-
javax.annotation.processing相关 API 只在compile-timeclasspath 有效，打不出 jar 包运行
为什么 @Repeatable 注解取不到多个实例？
因为 JVM 不直接支持重复注解——它其实是语法糖。你写的 @Role("admin") @Role("user")，编译后会被转成一个容器注解（如 @Roles({@Role("admin"), @Role("user")})）。所以不能用 getAnnotation(Role.class) 拿全部，得用 getAnnotationsByType(Role.class)。
注意点：
- 容器注解必须用
@Retention和@Target，且value()方法返回Role[]类型 -
getAnnotation(Class)永远只返回一个（或 null），getAnnotationsByType才能展开重复项 - 如果容器注解本身也被重复标记（极少见），
getAnnotationsByType仍能正确聚合
复杂点在于嵌套泛型或自定义容器命名冲突——一旦容器类名或 value() 签名不对，编译器不会报错，但运行时 getAnnotationsByType 返回空数组，很难排查。
