Java中实现动态注解重复需使用@Repeatable元注解并定义匹配的容器注解，容器注解必须含value()方法返回目标注解数组、保留到运行时且@Target兼容，再通过getAnnotationsByType()获取重复实例。
Java中实现动态注解重复，核心在于正确使用@Repeatable元注解，并配套定义一个“容器注解”。这不是简单加个@Repeatable就能生效，必须满足特定结构和命名约定，否则编译器会报错或运行时无法识别重复注解。
容器注解必须是数组类型且返回值为目标注解
被@Repeatable标记的注解（如@Role）必须指定一个容器注解类。这个容器注解本身不能是普通注解，而必须声明一个名为value的属性，其类型是目标注解的数组。例如：
@Repeatable(Roles.class)
public @interface Role {
String value();
}
public @interface Roles {
Role[] value();
}
立即学习“Java免费学习笔记（深入）”；
注意：
• 容器注解名通常为复数形式（如Roles），但不是强制，关键是类型匹配；
• value()方法必须存在且返回目标注解数组；
• 若容器注解缺少value属性，或类型不匹配（比如返回String[]），编译将失败。
注解使用时支持多次声明
定义好@Repeatable和容器后，可在同一元素上重复使用该注解：
@Role("ADMIN")
@Role("EDITOR")
@Role("VIEWER")
public class User { }
此时JVM会自动将三个@Role收集到一个@Roles实例中。可通过反射获取：
Role[] roles = userClass.getAnnotationsByType(Role.class);
// 直接获取所有@Role，无需手动解析@Roles
说明：
• getAnnotationsByType()是关键，它能自动展开重复注解；
• 使用getAnnotation()只能拿到容器注解（@Roles），需再调用.value()提取；
• Java 8+ 默认支持此机制，无需额外配置。
容器注解需保留在运行时且与目标注解在同一作用域
容器注解必须保留到运行期，否则反射读取不到：
@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.TYPE)
public @interface Roles {
Role[] value();
}
同时，容器注解的@Target必须兼容目标注解的使用位置。例如，若@Role允许标注在方法上（@Target(METHOD)），那么@Roles也必须声明@Target(METHOD)或更宽泛的范围（如TYPE_OR_METHOD）。否则在方法上使用多个@Role会编译报错。
常见错误与规避方式
• 忘记声明容器注解的@Retention：导致运行时反射为空；
• 容器注解value()方法名或类型写错：如写成roles()或Role value;（缺少括号）；
• 容器注解未声明@Target，或范围小于目标注解：触发编译错误“Invalid target for annotation”；
• 误用getAnnotation()代替getAnnotationsByType()：拿不到重复项，只返回一个@Roles。
