Java 8 的 @Repeatable 注解必须配合容器注解使用，因为 JVM 限制每个位置仅存一种注解类型，容器类用于包裹多个同类型实例；定义时需两步：目标注解标注 @Repeatable(容器类.class)，容器类需匹配元注解且含 value() 返回目标注解数组；运行时应使用 getAnnotationsByType() 获取重复实例。
Java 8 引入了 @Repeatable 注解，让同一个注解可以在同一位置多次使用。但要真正生效，它必须配合一个“容器注解”（container annotation）一起工作——这不是可选配置，而是强制要求。
为什么需要容器类？
@Repeatable 本身只是一个标记，告诉编译器“这个注解允许重复”，但 JVM 在底层仍只允许每个位置保留一种注解类型的一份元数据。为了兼容这一限制，Java 要求你提供一个专门的容器注解，用于“包裹”多个同类型注解实例。编译器会自动把多个重复注解收集成该容器类型的一个实例。
如何正确定义可重复注解？
定义分两步，缺一不可：
- 定义目标注解，并用
@Repeatable(XXX.class)指向它的容器类（如@Repeatable(Roles.class)） - 定义容器注解：必须是
@Retention和@Target与目标注解一致，且其唯一抽象方法必须返回目标注解类型的数组（如Role[] value() default {};）
运行时如何获取重复注解？
不能直接用 getAnnotation(Class) 获取重复注解，因为 JVM 存储的是容器类型。正确方式有两种：
立即学习“Java免费学习笔记（深入）”；
- 调用
getAnnotation(ContainerClass.class)，再取其数组字段 - 更推荐：使用
getAnnotationsByType(TargetAnnotation.class)—— 这是 Java 8 新增的方法，会自动解包容器，返回所有重复注解的实例列表
常见误区提醒
容易出错的地方包括：
- 容器注解忘了加
@Retention和@Target，导致运行时无法读取 - 容器方法名不是
value()或返回类型不匹配（必须是目标注解类型的数组） - 误用
getAnnotation()而非getAnnotationsByType()，结果始终为null
不复杂但容易忽略细节。写对容器类结构，再用对获取方式，就能安全支持多实例注解场景。
