Java 8的@Repeatable注解需配合容器注解使用，容器注解必须满足：声明@Retention和@Target、value()返回原注解数组、@Target不窄于原注解、不可再标记@Repeatable；@Repeatable参数必须指向该容器类型；反射应使用getAnnotationsByType()自动解包。
Java 8 引入了 @Repeatable 注解，让同一个注解可以在同一位置多次使用。但要真正生效，必须配合“容器注解”（Container Annotation）一起使用——这不是语法糖，而是有明确契约的容器模式。
容器注解必须满足三个硬性条件
被 @Repeatable 标记的注解（如 @Role）本身不能直接重复，它需要一个专门的“收纳盒”，这个收纳盒就是容器注解（如 @Roles）。该容器注解需满足：
- 必须声明为
@Retention和@Target，且其value()方法返回原注解类型的数组（如Role[] value();） - 容器注解的
@Target必须与原注解一致，或更宽泛（否则编译报错） - 容器注解不能也标记
@Repeatable，否则形成循环依赖
@Repeatable 的元注解必须指向容器类型
在定义可重复注解时，@Repeatable 的唯一参数必须是容器注解的 Class 对象。例如：
@Repeatable(Roles.class)
public @interface Role {
String value();
}
这里 Roles.class 就是容器类型，编译器会自动将多个 @Role 合并为一个 @Roles({@Role("a"), @Role("b")}) 存储。反射读取时，推荐直接调用 getAnnotationsByType(Role.class)，它会自动解包容器内容；若用 getAnnotations()，则只能拿到 @Roles 实例。
立即学习“Java免费学习笔记（深入）”；
容器注解名无强制约定，但需保持语义清晰
容器注解名称通常为原注解的复数形式（如 Role → Roles），但这只是惯例，不是语法要求。关键在于：容器注解的 value() 方法签名必须严格匹配。比如：
public @interface Roles {
Role[] value(); // 必须是 Role[]，不能是 List<Role> 或 Role...
}
如果方法名不是 value()，或者返回类型不匹配，编译器会拒绝该 @Repeatable 声明。
运行时获取重复注解的正确姿势
反射层面，JVM 会把多个同名注解“折叠”进容器中。因此：
- 用
element.getAnnotationsByType(Role.class)可直接获得所有@Role实例，无需手动解包 - 用
element.getAnnotation(Roles.class)能拿到容器实例，再调.value()手动展开 - 避免用
getAnnotations()遍历，因为它只返回顶层注解（即@Roles），不会包含原始的@Role元素
