@inherited仅影响类继承链上class.getannotation()的查找行为,只适用于@target(type)且@retention(runtime)的类级注解,不作用于接口、方法、字段等其他元素。

因为 @Inherited 的设计目标非常明确:它只改变 Class.getAnnotation() 在类继承链(extends)上的查找行为,其他所有场景都不在它的作用范围内。
只面向类继承,不处理接口实现
Java 语言规范明确定义:“@Inherited only causes annotations to be inherited from superclasses; annotations on implemented interfaces have no effect.”
JVM 反射机制在调用 clazz.getAnnotation(Anno.class) 时,只会调用 clazz.getSuperclass() 向上遍历父类,完全忽略 clazz.getInterfaces() 返回的任何接口。接口是契约关系(implements),不是父子类型关系(is-a),而 @Inherited 的语义边界就是「类 → 子类」这一条单向、单根路径。
方法和字段注解本身不参与继承语义
方法重写(override)和字段遮蔽(hiding)是运行时行为,不是元数据继承。JVM 规定:
Java项目代码review工具。分析Git变更+完整调用链路上下文,推断业务需求,进行多维度评分和分类汇总,生成完整PRD文档。包含细粒度Java代码审查清单(Null安全、异常处理、Streams、并发、equals/hashCode、资源管理、API设计、性能、MyBatis/ORM、事务边界、SQL/DD...
- 每个
Method对象只携带它**声明处**的注解,父类方法上的注解不会“附着”到子类方法对象上 - 子类重写后调用
getMethod("xxx").getAnnotation(),查的是子类自己的Method实例,不是父类的 - 字段同理:子类声明同名字段只是遮蔽,
getDeclaredField()永远只返回当前类定义的字段元数据
@Inherited 不是注解复制机制,而是反射查找开关
@Inherited 不会让子类字节码中多出一条注解,也不影响编译或注解处理器。它只是让 getAnnotation() 和 isAnnotationPresent() 这两个方法自动向上搜索——而且仅限于 @Target(ElementType.TYPE) 且 @Retention(RUNTIME) 的类级注解。只要注解标在方法、字段、参数、接口上,哪怕加了 @Inherited,也完全不会触发任何查找逻辑。
替代方案必须手动实现
如果业务需要获取接口或父类方法上的注解,不能依赖 @Inherited,得主动扫描:
- 对类:循环调用
clazz = clazz.getSuperclass(),每层都试getAnnotation() - 对方法:从子类开始用
getDeclaredMethod()查,没找到就向上找父类同签名方法 - 对接口:调用
clazz.getInterfaces(),再递归遍历每个接口及其父接口,并检查iface.getDeclaredMethod().getAnnotation()
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南










