@inherited仅在子类显式继承（extends）标注了该元注解的父类时生效，且注解必须作用于父类class上；不适用于方法、字段、接口实现或间接继承。
@Inherited 是 Java 中一个特殊的元注解，但它只对类的注解生效，且仅在被子类直接继承（extends）时才传递。它不适用于方法、字段或接口实现，也不支持“跨层”或“间接”继承。很多开发者误以为在抽象父类上加了 @Inherited 注解，子类就能自动获得该注解的语义逻辑——其实不然：@Inherited 控制的是注解本身的可见性传递，而非运行时行为的自动注入。
哪些场景下 @Inherited 真正起作用？
只有满足以下全部条件，子类才能通过 getAnnotation() 获取到父类上的注解：
- 注解本身用
@Inherited修饰（即元注解声明） - 该注解被标注在父类的 class 上（不能是方法或字段）
- 子类通过
extends显式继承该父类（不能是实现接口或组合） - 调用
子类.class.getAnnotation(YourAnno.class)时返回非 null
例如：
自定义注解：@Inherited
@Retention(RetentionPolicy.RUNTIME)
public @interface ApiVersion {
String value() default "1.0";
}
抽象父类：
@ApiVersion("2.0")
public abstract class BaseController { }
子类：
public class UserController extends BaseController {
public static void main(String[] args) {
// ✅ 返回 ApiVersion("2.0")
ApiVersion anno = UserController.class.getAnnotation(ApiVersion.class);
System.out.println(anno.value()); // 输出：2.0
}
}
常见误区与失效情况
这些写法不会触发 @Inherited 的传递效果：
- 把
@ApiVersion标在BaseController的某个方法上 → 方法注解不受 @Inherited 影响 - 子类实现接口
implements ApiCapable，而接口上有@ApiVersion→ 接口注解不被 @Inherited 处理 - 使用 Spring 的
@RestController或@Service等复合注解 → 它们内部虽可能含 @Inherited，但实际是否传递取决于其自身定义及 Spring 的处理逻辑，不是自动继承 - 抽象类未被子类
extends，而是被@Autowired注入或作为成员变量使用 → 无继承关系，注解不可见
如何让“注解语义”真正向下传递？
@Inherited 只解决“能不能 getAnnotation”，不解决“要不要执行对应逻辑”。若想让子类自动具备某种能力（如统一日志、版本校验），需配合其他机制：
-
模板方法模式 + 注解扫描：在抽象父类定义
protected abstract void doHandle()，并在handle()模板方法中读取this.getClass().getAnnotation(ApiVersion.class)做预处理 -
Spring AOP 切面：切
@Within(BaseController+)或@Target(Class)注解的类，统一织入逻辑 - 自定义 BeanPostProcessor：在 Spring 容器启动时扫描所有继承自 BaseController 的 Bean，检查并注册其注解元数据
替代方案：更可控的注解传播方式
如果需要更灵活的注解继承语义（比如支持接口、方法、多级继承），可放弃 @Inherited，改用工具类手动查找：
public static <a extends annotation> A findAnnotation(Class> clazz, Class</a><a> annotationType) {
while (clazz != null && clazz != Object.class) {
A ann = clazz.getAnnotation(annotationType);
if (ann != null) return ann;
clazz = clazz.getSuperclass();
}
return null;
}</a>
这个方法能穿透继承链，也兼容接口（需额外遍历 getInterfaces()），比 @Inherited 更可靠、更透明。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
