Java注解不支持方法继承，@Inherited对方法无效；正确做法是沿类继承链向上查找原始声明处的注解，结合泛型擦除特性使用getDeclaredMethods()逐级扫描，Spring的AnnotationUtils.findAnnotation底层即采用此逻辑。
Java 中自定义注解不会自动被子类继承，尤其当它标注在父类泛型抽象类的方法上时，反射识别更易出错——这不是 bug，而是 Java 注解机制的明确设计。关键不在“怎么让子类继承”，而在于如何正确获取原始声明处的注解。
一、父类泛型抽象方法上的注解不会出现在子类重写方法上
假设父类是泛型抽象类：
public abstract class BaseService<T> {
@Loggable
public abstract void process(T item);
}子类实现：
public class UserService extends BaseService<User> {
@Override
public void process(User item) { ... }
}此时：
立即学习“Java免费学习笔记（深入）”；
-
UserService.process(...)方法自身没有@Loggable注解（即使没显式标注）； -
getDeclaredMethod("process", User.class).getAnnotation(Loggable.class)返回null； - 注解只绑定在
BaseService.process(T)这个原始声明位置，且因泛型擦除，参数类型在字节码中是Object。
✅ 正确做法：不查子类方法，而是沿继承链向上，找到 BaseService.class 中那个带 @Loggable 的抽象方法。
二、反射识别必须绕过泛型擦除 + 向上查找声明类
直接用 getMethod("process", User.class) 会失败（因擦除后签名是 (Object)），应：
- 先获取所有候选方法（不依赖具体参数类型）；
- 按方法名 + 参数数量匹配；
- 再逐级向上查找，直到找到带目标注解的原始声明。
推荐步骤：
- 获取子类
Class<?> subCls = UserService.class； - 调用
subCls.getSuperclass()得到BaseService.class； - 遍历
BaseService.class.getDeclaredMethods()； - 筛选方法名匹配（如
"process"）、修饰符含abstract、且有@Loggable注解的方法； - 若父类仍是泛型（如
BaseService<T>），注意其getGenericParameterTypes()可还原泛型信息，但getDeclaredMethod()必须用擦除后的类型（即Object.class）。
示例代码片段：
Method findAnnotatedMethod(Class<?> start, String name, Class<? extends Annotation> annType) {
Class<?> cls = start;
while (cls != null && cls != Object.class) {
for (Method m : cls.getDeclaredMethods()) {
if (m.getName().equals(name) && m.isAnnotationPresent(annType)) {
return m;
}
}
cls = cls.getSuperclass();
}
return null;
}调用：findAnnotatedMethod(UserService.class, "process", Loggable.class) → 返回 BaseService.process(T) 对应的 Method 对象。
三、Spring 工具可简化操作，但需理解底层逻辑
Spring 的 AnnotationUtils.findAnnotation(Method, Class) 内部就是做继承链遍历，但它有个前提：传入的 Method 对象必须能定位到原始声明上下文（比如来自 BaseService.class.getDeclaredMethod(...)）。若你传的是子类 getDeclaredMethod 找不到的方法，它也无法凭空恢复。
⚠️ 注意：
-
AnnotationUtils.findAnnotation(method, Loggable.class)对子类重写后的方法对象无效（因为该对象本身无注解）； - 应配合
ClassUtils.getUserClass(obj)或AopProxyUtils.ultimateTargetClass()获取真实目标类，再结合AnnotationUtils.resolveAnnotationAttributes(...)处理泛型边界。
四、泛型抽象类 + 注解的可靠实践建议
- ✅ 自定义注解务必加
@Retention(RUNTIME)，否则反射根本读不到； - ✅ 不依赖
@Inherited——它对方法注解完全无效； - ✅ 避免在子类方法上重复标注相同注解（易造成维护歧义）；
- ✅ 若需统一拦截，优先在抽象模板方法上标注，再用 AOP 或代理在运行时解析原始声明；
- ✅ 缓存查找结果：继承链扫描开销大，建议用
ConcurrentMap<MethodKey, Method>缓存已定位的原始方法。
不复杂但容易忽略。
