如何在 Java 中通过 Inherited 注解让父类上的标注信息能够自动被子类继承

先说一个Ja va注解使用中的常见误解：很多人以为 @Inherited 能让子类自动继承父类的注解，但事实远没那么简单。它只对类上直接标注的注解生效，而且是必须被 @Inherited 元注解标记过的注解才行，根本无法穿透到方法、字段或接口实现上。

为什么 @Inherited 看起来“不工作”

这确实是最容易踩的坑。@Inherited 并不是让子类“继承父类所有注解”，它的作用范围窄得超乎想象：当一个类 A 被某个带 @Inherited 的注解（比如你自定义的 @MyAnnotation）标注时，子类 B 在调用 B.class.getAnnotation(MyAnnotation.class) 才有机会拿到它——前提是 @MyAnnotation 自身声明了 @Inherited，并且 A 是直接标注者。换个说法，这个机制只认“原生标注”，不认间接传递。

• 父类方法上的注解，无论有没有 @Inherited，子类重写之后通通拿不到。因为 getDeclaredMethod(...).getAnnotation(...) 查的是当前声明处，跟继承链无关。
• 接口上的注解永远不会被实现类继承。@Inherited 对接口声明毫无效果，哪怕你标注得再认真，实现类也感知不到。
• 如果父类本身不是直接标注，而是通过其他注解间接获得（比如 Spring 的 @Service 组合了某个注解），那更不会往下传递。这种“元注解”场景完全是另一套机制了。

如何真正让子类“看到”父类的注解

既然原生机制靠不住，那就只能手动扫描继承链。核心思路很简单：遍历 Class.getSuperclass() 和 Class.getInterfaces()，逐层调用 getAnnotation()。

• 如果只查类层级（不递归查接口），一个 while 循环就够了：Class clazz = targetClass; while (clazz != null) { ... clazz = clazz.getSuperclass(); }
• 要支持接口，就得多一步：处理 clazz.getInterfaces() 并递归其父接口。这里得小心循环引用，比如 Iterable 和 Collection 的关系，不加保护容易栈溢出。
• Spring 的 AnnotationUtils.findAnnotation() 正是这么实现的，它比原生 getAnnotation() 多走了一层继承查找，这也是为什么很多框架能“自动发现”父类注解的原因。
• 一个简单的递归示例：

  public static  T findAnnotation(Class clazz, Class annotationType) {    T ann = clazz.getAnnotation(annotationType);    if (ann != null) return ann;    Class sup = clazz.getSuperclass();    if (sup != null) {        ann = findAnnotation(sup, annotationType);        if (ann != null) return ann;    }    return null;}

@Inherited 的唯一有效使用场景

说到底，@Inherited 只在一个地方真正有用：当你在定义自己的注解，并且希望它能被子类“类级别继承”时，才需要加上它。否则，写了也是白写。

• 必须写在自定义注解的定义上：

  @Target(ElementType.TYPE)@Retention(RetentionPolicy.RUNTIME)@Inheritedpublic @interface MyConfig { String value() default ""; }

• 父类标注后，子类通过 SubClass.class.getAnnotation(MyConfig.class) 就能拿到，前提是子类没有用自己的同名注解覆盖掉。
• 如果去掉 @Inherited，哪怕父子类结构一模一样，子类也查不到。就是这么严格。
• Spring Boot 的 @Configuration、JUnit5 的 @TestInstance 都用到了这个机制，但它们内部还做了更多兼容处理，比如组合注解的合并和桥接方法的判断。

真正麻烦的从来不是加不加 @Inherited，而是你得想清楚：到底要继承哪一层的注解？类？方法？参数？有没有元注解嵌套？要不要考虑桥接方法？这些都得手动处理，JVM 不会替你猜。