Java原生getAnnotation()无法获取嵌套注解，因其只读取直接声明的注解；Spring的AnnotationUtils.findAnnotation支持递归查找嵌套注解，推荐优先使用。
理解嵌套注解为什么不能直接 getAnnotation
Java 原生的 getAnnotation() 只能读取直接声明在目标元素（类、方法、字段等）上的注解，无法穿透到注解内部的属性值——尤其是当该属性本身又是另一个注解类型时。比如你写了 @Validated(groups = MyGroup.class)，想拿到 MyGroup.class，这没问题；但若写成 @MyWrapper(@NotNull)，想取出里面的 @NotNull，原生 API 就无能为力了，因为 @MyWrapper.value() 返回的是 Annotation 类型，而 JVM 不会自动解析它为具体注解实例。
用 Spring 的 AnnotationUtils 获取嵌套注解
AnnotationUtils 提供了 getAnnotationAttributes 和更实用的 findAnnotation / getAnnotation 重载方法，它们能递归扫描注解链。关键在于：Spring 会把注解属性中声明的注解（即嵌套注解）也当作“可查找目标”，只要传入正确的注解类型和搜索策略。
- 对单个注解属性是嵌套注解的情况，用
AnnotationUtils.getAnnotation(annotatedElement, wrapperType).value()拿到原始Annotation对象，再用AnnotationUtils.synthesizeAnnotation(...)转成可调用的代理实例 - 更推荐方式：用
AnnotationUtils.findAnnotation(target, nestedAnnotationType)，它默认开启深度搜索（包括注解的注解属性），适合大多数场景 - 如果嵌套多层（如
@A(@B(@C))），需配合SearchStrategy.TYPE_HIERARCHY或自定义遍历逻辑，findAnnotation默认只查一层嵌套，必要时要手动展开
动手写一个安全读取嵌套注解的工具方法
下面是一个通用方法，能从任意被注解的目标上，按类型找到所有嵌套层级中的指定注解：
public static <A extends Annotation> A findNestedAnnotation(AnnotatedElement source, Class<A> annotationType) {
// 先查直接声明的
A direct = AnnotationUtils.getAnnotation(source, annotationType);
if (direct != null) return direct;
// 再查所有注解的属性值（递归）
Annotation[] allAnnos = source.getAnnotations();
for (Annotation anno : allAnnos) {
for (Method attr : anno.annotationType().getDeclaredMethods()) {
if (attr.getParameterCount() == 0 && Annotation.class.isAssignableFrom(attr.getReturnType())) {
try {
Annotation nested = (Annotation) attr.invoke(anno);
if (nested != null && nested.annotationType() == annotationType) {
return (A) nested;
}
// 递归进嵌套注解内部继续找
A foundInNested = findNestedAnnotation(nested, annotationType);
if (foundInNested != null) return foundInNested;
} catch (Exception ignored) {}
}
}
}
return null;
}
这个方法不依赖 Spring，但如果你已在用 Spring，优先用 AnnotationUtils.findAnnotation + 自定义 AnnotationFilter 更简洁可靠。
常见陷阱与绕过技巧
实际使用中容易踩坑：
-
注解属性必须有默认值：如果嵌套注解作为属性但没设默认值（如
MyAnn value() default @Inner;缺失），JVM 会抛AnnotationFormatError，编译期就失败 -
重复注解不被自动展开：像
@Repeatable容器注解里的多个同类型嵌套注解，findAnnotation默认只返回第一个，需改用getAnnotationsByType配合手动解析 -
运行时代理失效：用
synthesizeAnnotation创建的代理对象，其方法返回值如果是泛型或数组，可能需额外处理（比如用AnnotationUtils.getValue(anno, "xxx")替代直接 getter）
遇到复杂结构，建议先用 AnnotationUtils.getAnnotationAttributes 把整个注解转成 Map，再按 key 逐层 inspect，比硬刚反射更稳。
