@Repeatable解析底层原理_反射如何通过容器类批量获取@Repeatable注解-java教程-PHP中文网

@repeatable 通过编译器自动封装为容器注解并增强反射语义实现重复标注，字节码中仅存容器注解，需用 getannotationsbytype() 获取间接存在的重复注解。

@repeatable解析底层原理_反射如何通过容器类批量获取@repeatable注解

Java 的 @Repeatable 不是“绕过”注解限制，而是用编译器自动封装 + 反射语义增强的方式，让重复标注在写法上更自然、在运行时仍可统一处理。

Java 字节码规范规定：同一个元素（如类、方法）的 RuntimeVisibleAnnotations 属性里，**同类型注解只能出现一次**。所以 @Repeatable 并没有打破这条规则，而是由编译器完成三步转换：

检查该注解是否被 @Repeatable(Container.class) 标注，并确认 Container 是合法容器（含 value() 方法，返回对应注解类型的数组）
将所有重复出现的 @Author(...) 实例，打包成一个 @Authors({@Author(...), @Author(...)}) 容器注解
最终字节码中，目标元素只记录 @Authors 这一个注解 —— @Author 本身不会直接出现在注解表里

你可以用 javap -v YourClass.class 验证：看到的只有 @Authors，其 value 数组里才藏着两个 @Author 实例。

普通反射方法（如 getAnnotation(Author.class)）只查“直接存在”的注解，而 @Author 在字节码里并不直接存在，所以会返回 null。真正能批量拿到重复注解的是以下两个方法：

getAnnotationsByType(Author.class)：返回所有 Author 实例（包括“间接存在”的，即从 @Authors.value() 中提取的）
getDeclaredAnnotationsByType(Author.class)：同上，但不继承父类/接口上的重复注解

这两个方法会自动识别容器注解（如 @Authors），并把它的 value() 数组展开，合并父类中同类型的重复注解（若使用 ByType 版本），最终返回干净的 Author[] 数组。

如果自定义重复注解，容器类写错，编译直接失败。核心要求有：

@Retention 必须与重复注解完全一致（比如都是 RUNTIME），否则反射无法还原
@Target 要覆盖或等于重复注解的目标范围（例如 @Author 标在方法上，则 @Authors 的 @Target 至少也要包含 METHOD）
value() 方法必须存在，且返回类型严格为 Author[]（不能是 List<author></author> 或其他包装）
容器注解自身不能也被 @Repeatable 标注（禁止嵌套容器）

这是 Java 反射 API 对“存在形式”的明确定义：

directly present：字节码中 RuntimeVisibleAnnotations 表里真实列出的注解 → @Authors 属于这一类
indirectly present：通过容器注解的 value() 数组间接关联的注解 → @Author 属于这一类
getAnnotation() 只查 directly present；getAnnotationsByType() 则查所有 “associated” 注解（directly + indirectly + 父类 inherited）

换句话说：不是反射“漏了”，而是设计上就区分了“物理存在”和“逻辑存在”。你要的是逻辑语义上的多个 @Author，就得用匹配语义的方法。