反射读取嵌套注解本质是逐层获取运行时注解实例：外层注解元素必须为内层注解类型且两者均需@Retention(RUNTIME)；获取外层实例后直接调用其方法得到内层代理对象，再递归处理，注意空值检查、禁止对注解调用getAnnotation、限制递归深度。
反射读取嵌套注解，本质是“一层层打开注解的盒子”：外层注解里存着内层注解（或其数组），而内层注解本身也是运行时可查的对象——只要它的 @Retention(RetentionPolicy.RUNTIME) 生效，就能继续用反射读取。
嵌套注解必须满足的两个前提
不是所有注解都能被递归读取，以下两点缺一不可：
-
外层注解的元素类型要是另一个注解类，例如：
MyInner[] value();或MyInner config();，不能是 String、int 等基础类型； -
被嵌套的注解（内层）也必须声明为
@Retention(RUNTIME)，否则调用inner.getAnnotation(...)会返回 null，递归就断了。
标准递归读取步骤（以数组型嵌套为例）
假设你有如下结构：
@interface Outer {
Inner[] value();
}
@interface Inner {
String name();
int level();
}
那么在运行时解析逻辑如下：
- 先通过
clazz.getAnnotation(Outer.class)拿到外层注解实例； - 调用该实例的
value()方法，得到Inner[]数组； - 遍历数组，对每个
Inner inner直接调用其方法，如inner.name()—— 注意：这里不需要再反射！因为 inner 已是运行时生成的代理对象，方法调用会被自动转发到注解属性值； - 若 Inner 内部还嵌套了 Third 注解（比如
Third extra();），则对每个 inner 再调用inner.extra()，然后继续对其返回值做同样处理。
遇到复杂嵌套时的注意事项
真实项目中容易踩坑的地方：
-
空值检查不能省：外层注解可能没标注，
getAnnotation(Outer.class)返回 null；数组元素也可能为 null（虽然编译器通常不允），建议加if (inner != null)防御； -
不要试图对注解实例调用
getAnnotation：注解对象本身不是 Class，没有getAnnotation方法。想读 inner 里的 third，直接inner.extra().xxx()即可； - 循环嵌套需设深度限制：如果设计成 A→B→A→B…，递归不加终止条件会 StackOverflow。建议传入 depth 参数，超过 5 层就告警或截断。
简化多层解析的实用技巧
避免每次手动写 for 循环，可封装一个通用工具方法：
- 接收任意注解对象，用反射获取它所有方法；
- 过滤出返回类型是
Annotation或其子接口的方法； - 对每个方法执行
method.invoke(annotation)，拿到返回值后判断是否为注解实例，是则递归处理； - 用
ConcurrentHashMap缓存已解析过的注解类型与字段映射，避免重复反射开销（尤其适合高频扫描场景）。
