@Inherited仅限类级注解继承，且子类未显式声明同名注解时才可通过getAnnotation获取父类注解；对方法、字段无效，需手动遍历继承链或改用模板方法模式。
Java 中没有名为 @Inherited 的“确保子类自动获取父类标注信息”的万能注解——@Inherited 是一个元注解，作用非常有限：它只对 类级别（TYPE）的注解 生效，且仅在 子类不显式声明同名注解时，才允许通过反射调用 getAnnotation(Class) 获取到父类上的该注解；它对方法、字段上的注解完全无效，也不影响注解内容的“继承传播”逻辑。
① @Inherited 的真实行为和前提条件
@Inherited 仅修饰其他自定义注解（即作为元注解），表示该注解具有“可被继承性”。但必须同时满足以下全部条件，子类才能通过 clazz.getAnnotation(MyAnno.class) 拿到父类的注解：
- 该注解本身用
@Inherited修饰（如@Target(ElementType.TYPE) @Retention(RetentionPolicy.RUNTIME) @Inherited public @interface MyAnno { ... }） - 该注解被标注在父类上（
@MyAnno class Parent { ... }），而非接口、方法或字段 - 子类未在自身类声明上重复使用该注解（
class Child extends Parent，而非@MyAnno class Child extends Parent） - 使用反射调用的是
Class#getAnnotation(Class)，不是getDeclaredAnnotation()或针对方法/字段的获取方法
② 常见误区：@Inherited 不适用于方法和字段
即使你给一个方法注解加了 @Inherited，子类重写该方法后，childClass.getMethod("xxx").getAnnotation(MyMethodAnno.class) 依然返回 null。JVM 规范明确指出：@Inherited 对 METHOD、FIELD 等目标类型无意义。这是语言层面的限制，无法绕过。
例如：
立即学习“Java免费学习笔记（深入）”；
将后端 Java 接口文档转换为前端 TypeScript 类型定义（interface / type）。输入：飞书文档、Spring Boot 接口文档、Swagger/OpenAPI、手写 API 文档等。输出：包含请求参数与响应结果的 .md 文件，含完整 JSDoc 注释。触发关键词：Java 转 TS、接口转换、生成前端类型、接口文档转 TypeScript、DTO/VO/BO 转 interface、后端文档转前端类型、生成接口类型、类型定义生成。
@Target(ElementType.METHOD) @Retention(RetentionPolicy.RUNTIME) @Inherited
@interface Loggable {}
class Service {
@Loggable void process() {}
}
class UserService extends Service {
@Override void process() {} // 此处不会自动获得 @Loggable
}
此时 UserService.class.getMethod("process").getAnnotation(Loggable.class) 一定为 null。
③ 如何真正“让子类感知父类的注解信息”？
若业务需要子类运行时知晓父类（甚至祖先类）某类注解的存在或值，需手动遍历类继承链。推荐方式如下：
-
向上查找类注解：写工具方法遍历
clazz = clazz.getSuperclass()直到null，对每个Class调用getAnnotation(MyAnno.class) -
统一提取逻辑封装：例如 Spring 的
AnnotationUtils.findAnnotation()就支持跨类层级查找（包括接口、父类、泛型超类） - 避免依赖 @Inherited 实现核心逻辑：把它看作一种可选优化（省一次循环），而非功能必需
④ 替代方案：用抽象模板 + 模板方法模式替代注解继承
如果注解本质是用于控制行为（如“是否启用缓存”、“日志级别”），更健壮的做法是：
- 将配置项抽取为抽象类的 protected 字段或 final 方法（如
protected boolean isCacheEnabled() { return true; }） - 子类可选择重写，也可直接继承默认值
- 运行时逻辑统一调用该方法，不依赖反射和注解查找
这种方式类型安全、IDE 可导航、测试友好，比基于 @Inherited 的反射方案更可控。
