cglib动态代理子类丢失父类注解是必然结果：因java注解默认不继承，@inherited仅对类级type注解生效且不影响方法级注解，而cglib生成的子类不复制注解字节码。
CGLIB 动态代理生成的子类丢失父类注解，不是偶然 bug，而是 Java 注解机制与 CGLIB 代理原理共同作用下的必然结果：CGLIB 创建的是继承父类的新子类，但 Java 默认不自动继承类或方法上的注解——除非显式声明 @Inherited（且仅对类级别 TYPE 注解生效），而方法级注解根本不受 @Inherited 影响。
为什么 CGLIB 子类没有注解
CGLIB 通过字节码增强生成目标类的子类（如 UserService$$EnhancerByCGLIB$$abc123），这个子类只重写 public/non-final 方法，不复制父类的注解信息。JVM 加载该子类时，其 Class.getAnnotations() 返回空数组，因为注解未被继承，也不是字节码中的一部分。
- 类上注解（如
@Service、@Controller）丢失 → 导致 Spring 扫描不到 Handler、Bean 识别异常 - 方法上注解（如
@Transactional、@Validated、自定义@Retryable）丢失 → AOP 切点匹配失败，事务/校验/重试逻辑不触发 - 接口方法上的注解在实现类 CGLIB 代理后同样不可见 → 因为代理类没实现接口，也不继承接口方法的元数据
快速定位是否是注解丢失问题
不要靠肉眼判断代理类有没有注解，用代码验证：
deep-java-review
下载
Java项目代码review工具。分析Git变更+完整调用链路上下文，推断业务需求，进行多维度评分和分类汇总，生成完整PRD文档。包含细粒度Java代码审查清单（Null安全、异常处理、Streams、并发、equals/hashCode、资源管理、API设计、性能、MyBatis/ORM、事务边界、SQL/DD...
- 打印实际运行时的 bean 类型：
log.info("bean type: {}", bean.getClass());—— 若看到$$EnhancerByCGLIB$$后缀，说明已走 CGLIB - 检查注解是否存在：
AnnotationUtils.findAnnotation(bean.getClass(), YourAnnotation.class)（Spring 工具类，会递归查父类） - 对比原始类与代理类的方法注解：
AnnotationUtils.findAnnotation(targetMethod, YourAnnotation.class)vsAnnotationUtils.findAnnotation(proxyMethod, YourAnnotation.class) - 断点进入 AOP 切面（如
TransactionInterceptor.invoke()），看TransactionAttributeSource.getTransactionAttribute(method, targetClass)是否返回 null
恢复注解可见性的可行方案
核心思路：让 Spring 在代理类或目标方法上「能看见」注解，而不是指望 JVM 自动继承。
-
优先使用
AnnotationUtils.findAnnotation()替代原生反射：它会沿继承链向上查找，自动回溯到父类或接口，适用于类级和方法级注解 -
自定义
BeanPostProcessor搬运注解：在 bean 初始化前，扫描目标类方法，把接口或父类方法上的注解“复制”到代理类对应方法上（需用ReflectionUtils.doWithLocalMethods()+AnnotationUtils.synthesizeAnnotation()） -
启用
@Inherited（仅限类级注解）：若自定义注解用于类标识（如@MyComponent），在其定义上加@Inherited，并确保代理类创建时保留该语义 -
避免依赖注解继承，改用显式标注：在实现类方法上直接写
@Transactional或@Validated，最稳定，无兼容性风险
预防后续同类问题
从设计源头降低对注解继承的依赖：
- 事务、校验、重试等关键切面，一律标注在实现类的 public 方法上，不依赖接口或父类声明
- 自定义注解定义时明确
@Target({ElementType.TYPE, ElementType.METHOD})和@Retention(RetentionPolicy.RUNTIME) - 禁用
CGLIB的场景（如 final 类、final 方法）提前暴露，避免运行时静默失效 - 单元测试中加入代理类注解检查断言，例如：
assertThat(AnnotationUtils.findAnnotation(service.getClass(), MyAnnotation.class)).isNotNull()
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
