根本原因是Class.getAnnotation()只支持单值注解，而@Repeatable注解是重复注解，必须用getAnnotationsByType()获取；其设计要求配套容器注解，JVM将多个原始注解打包进容器中存储。
Java中使用Class.getAnnotation()读取@Repeatable注解时返回null，根本原因在于：该方法只支持获取**单值注解**，而@Repeatable注解本质是**重复注解**，必须通过getAnnotationsByType()才能正确获取。
理解 @Repeatable 的设计机制
@Repeatable不是让同一个注解在类/方法上声明多次就自动合并，而是要求配套定义一个“容器注解”（container annotation）。JVM会将多个同类型重复注解，自动打包进这个容器注解中存储。因此：
- 原始注解（如
@Role("admin")）本身不能直接用getAnnotation(Role.class)查到 - 容器注解（如
@Roles({@Role("admin"), @Role("user")})）才是实际被写入字节码的注解 -
getAnnotation()只查找字节码中显式存在的注解，自然找不到@Role
正确获取重复注解的方法
必须使用getAnnotationsByType()——它由JVM提供语义支持，会自动解包容器注解，返回所有重复声明的原始注解实例：
// ✅ 正确方式
Role[] roles = clazz.getAnnotationsByType(Role.class); // 返回 Role 实例数组
for (Role role : roles) {
System.out.println(role.value()); // 如 "admin", "user"
}
注意：getAnnotationsByType()返回的是原始注解类型数组，不是容器类型；它对非@Repeatable注解也兼容（行为等同于getAnnotation()），但推荐统一使用以提高健壮性。
Alibabacloud Sdk Client Initialization For Java
下载
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
立即学习“Java免费学习笔记（深入）”；
检查注解定义是否合规
若仍返回空数组，需确认以下两点：
-
@Repeatable元注解的value值必须指向一个**合法的容器注解类**，且该类必须标注@Retention(RetentionPolicy.RUNTIME)和@Target（与原始注解一致） - 容器注解的value字段必须是原始注解类型的数组，且名称严格为
value（不可改名）
例如：@Repeatable(Roles.class) → @Roles必须有Role[] value() default {};
运行时环境与编译版本匹配
@Repeatable自Java 8引入，但完整支持依赖JVM实现。确保：
- 源码用
-source 8或更高版本编译 - 运行时JRE版本 ≥ 编译版本（如用JDK 17编译，避免在JRE 8上运行）
- IDE或构建工具（如Maven）未因配置问题忽略注解处理器或反射相关字节码信息
