@Repeatable并非绕过注解单次限制，而是编译器将多个同类型注解自动封装为容器注解（如@Roles），字节码中仅存该容器，运行时须用getAnnotationsByType()获取全部实例。
Java 的 @Repeatable 并不是真正“绕过”了注解单次限制，而是通过编译器与 JVM 协同实现的一套语法糖+容器映射机制：表面上你写了多个相同注解，底层实际仍只存在一个容器注解实例，所有重复项被自动收集进它的数组字段中。
编译期：自动合成容器注解
当你在类或方法上写：
@Role("ADMIN")<br>@Role("EDITOR")<br>public class UserService { }
javac 编译时会隐式生成一个 @Roles 容器实例，等价于：
@Roles({@Role("ADMIN"), @Role("EDITOR")})<br>public class UserService { }
这个过程完全由编译器完成，源码里无需显式声明容器——但容器注解必须已正确定义，否则编译失败。
立即学习“Java免费学习笔记（深入）”；
运行时：注解读取方式决定能否拿到全部
JVM 加载 class 后，反射 API 提供两种获取路径，行为完全不同：
-
getAnnotation(Role.class)→ 只返回第一个@Role（按规范，等价于getAnnotationsByType(Role.class)[0]） -
getAnnotationsByType(Role.class)→ 返回所有重复实例组成的数组，这是唯一推荐的读取方式 -
getAnnotation(Roles.class)→ 能拿到容器对象，再调用.value()手动展开，但多一层封装，不直观
容器注解不是可选配件，而是强制契约
要让 @Repeatable 生效，容器注解必须满足三项硬性要求：
- 方法签名必须为
XXX[] value()，返回类型严格匹配被重复注解的类型 -
@Target值不能比被重复注解更窄（例如@Role支持 TYPE 和 METHOD，@Roles至少也要支持这两个） -
@Retention策略不能比被重复注解更短（如@Role是 RUNTIME，@Roles也必须是 RUNTIME 或更长）
字节码层面：只存容器，不存重复项
反编译 class 文件后，你看不到多个 @Role 条目，只会看到一条 @Roles 注解，其 value 字段是常量池中嵌套的注解结构。JVM 规范规定：重复注解在字节码中必须以容器形式存储，@Repeatable 仅用于源码阶段的语法提示和编译器转换逻辑。
