getAnnotation()无法获取全部重复注解，因其只返回容器注解或null；而getAnnotationsByType()自动解包容器并返回所有重复注解实例。
Java 8 引入的 @Repeatable 注解，让同一个注解可以在同一元素上多次声明，但要真正读取这些重复注解，不能只靠 getAnnotation()——它只会返回一个实例，而是必须用 getAnnotationsByType() 才能获取全部。
为什么 getAnnotation() 拿不到所有重复注解？
因为 @Repeatable 的底层机制是：编译器会把多个同类型注解“打包”进一个容器注解（container annotation）。JVM 在运行时只保留这个容器注解，原始重复注解本身被转为容器中的数组元素。所以 getAnnotation(YourAnno.class) 实际查的是单个注解类型，自然只返回 null 或容器注解（如果容器类型恰好匹配），而不是你期望的多个 @YourAnno 实例。
正确获取重复注解的三步操作
要拿到全部重复注解实例，按顺序做这三件事：
- 定义你的自定义注解，并用
@Repeatable标明其容器类型（如@Repeatable(MyAnno.Container.class)） - 定义对应的容器注解（必须是
@Retention和@Target与原注解一致，且 value 成员类型为原注解数组） - 在反射时调用
element.getAnnotationsByType(MyAnno.class)，而非getAnnotation()
常见陷阱与绕过方式
如果你不小心用了 getDeclaredAnnotations()，会看到容器注解（比如 @MyAnno.Container），但它的 value() 方法返回的是原注解数组——你可以手动解包，但没必要。更稳妥的做法是统一使用 getAnnotationsByType()，它内部已自动处理解包逻辑。另外注意：该方法只对 @Retention(RetentionPolicy.RUNTIME) 的注解有效；若容器注解缺少 @Target 或 @Retention，或与原注解不一致，编译或运行时可能报错。
立即学习“Java免费学习笔记（深入）”；
实战小例子：权限校验场景
假设你写了一个 @RequiresRole 注解用于标记方法所需角色：
@Repeatable(RequiresRoles.class)
@interface RequiresRole {
String value();
}
@interface RequiresRoles {
RequiresRole[] value();
}
然后在方法上这样写：
@RequiresRole("ADMIN")
@RequiresRole("EDITOR")
public void publishArticle() { ... }
反射获取时只需一行：
RequiresRole[] roles = method.getAnnotationsByType(RequiresRole.class); —— 这样就能拿到两个实例，分别对应 "ADMIN" 和 "EDITOR"。
