子类通过反射获取父类注解需满足三条件:@target(elementtype.type)、@retention(runtime)、显式标注@inherited;应使用getannotation()或isannotationpresent(),而非getdeclaredannotation()或getannotations()。

要让子类通过反射拿到父类的注解,关键不是“怎么调用反射方法”,而是**注解本身是否被设计为可继承**。@Inherited 只起开关作用,且只对类级别注解生效,其他位置一律无效。
注解必须满足三个硬性条件
只有同时满足以下三点,子类调用 Class.getAnnotation() 才可能非 null:
- @Target 必须包含 ElementType.TYPE(即只能标注在类、接口、枚举上)
- @Retention 必须是 RetentionPolicy.RUNTIME(运行时保留,反射才可见)
- 必须显式加上 @Inherited 元注解
子类获取注解的正确方式
不要依赖 getDeclaredAnnotation()——它只查子类自己声明的注解,不看父类。应使用:
-
getAnnotation(Class
) :自动沿继承链向上查找,但仅对带 @Inherited 的 TYPE 级注解有效 -
isAnnotationPresent(Class
) :判断是否存在(含继承),比判空更轻量 - 避免 getAnnotations():返回所有注解数组,含无关注解,效率低且语义模糊
常见失效场景与应对
这些情况即使加了 @Inherited 也拿不到注解:
- 注解标在方法或字段上 → @Inherited 完全不生效,需手动遍历父类 Method/Field 调用 getDeclaredAnnotation()
- 父类实现某个接口,接口上有该注解 → 接口注解不会被实现类继承,JVM 不支持
- 多层间接继承(A → B → C)→ 实际仍能拿到 A 的注解,但若中间某层(如 B)自己也声明了同名注解,则会覆盖 A 的,不会合并
- @Repeatable 注解 → getAnnotation() 只返回一个实例,必须改用 getAnnotationsByType()
安全读取注解属性的要点
反射拿到的注解是动态代理对象,访问属性必须走接口方法:
- 写 anno.value(),不要用 Field.get() 或强转成具体类
- 数组类型(如 String[] tags())直接调用,返回的就是已初始化数组
- Class 类型属性(如 Class> service())返回对应 Class 对象,可继续反射操作
- 始终判空:getAnnotation() 返回 null 表示未声明,不是异常










