自定义注解在spring cglib代理下失效的根本原因是切面未触发，需从代理是否生成、调用是否走代理、注解是否可识别三方面排查：检查类/方法非final、启用proxytargetclass=true、避免this调用、注解保留策略为runtime且目标正确、切点表达式路径准确。
自定义注解在 Spring 代理（尤其是 CGLIB）下失效，本质是切面没被触发。排查要从“代理是否生成”“调用是否走代理”“注解是否可被识别”三个层面入手，而不是一上来就改代码。
确认代理对象是否真实存在
Spring AOP 生效的前提是目标类被成功代理。CGLIB 代理要求类不能是 final，方法也不能是 final 或 private。
- 检查类和方法：运行时打印该 Bean 的实际类型，比如 System.out.println(userService.getClass().getName())；若输出类似 UserService$$EnhancerBySpringCGLIB$$xxx，说明 CGLIB 代理已生效；若仍是原类名，说明代理未创建
- 验证配置：确保启用了 CGLIB 代理，例如在配置类上加 @EnableAspectJAutoProxy(proxyTargetClass = true)；Spring Boot 2.0+ 默认启用，但显式声明更稳妥
- 排除干扰：如果类实现了接口，Spring 可能默认走 JDK 代理（只代理接口方法），导致对类本身的方法注解不生效；此时强制 proxyTargetClass = true 可解决
验证方法调用是否经过代理链
即使代理对象存在，若调用路径绕过它（如 this.xxx()、new Xxx()、非 Spring 管理对象调用），注解照样静默失效。
Alibabacloud Sdk Client Initialization For Java
下载
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
- 禁止同类内 this 调用：带注解的方法不能被同一个类里的其他方法用 this.method() 调用；必须通过 Spring 容器注入自身或使用 AopContext.currentProxy()（需开启 expose-proxy）
- 检查调用方身份：Controller 或其他 Service 是否通过 @Autowired 注入该 Bean；若测试中直接 new 实例，或用反射 newInstance，AOP 不会介入
- 日志验证：在切面里加一行 log.debug("Entering: {}", joinPoint.getSignature())；没日志就说明根本没进切面，优先查代理和调用方式
核对注解定义与扫描范围
注解本身若定义不当，Spring 根本不会识别它，更谈不上织入。
- 保留策略必须是 @Retention(RetentionPolicy.RUNTIME)，否则运行时读不到
- 作用目标必须包含 @Target({ElementType.METHOD})（或加 ElementType.TYPE，视需求而定）
- 确保注解类在 Spring 扫描路径下，且所在模块被正确引入；Maven 多模块项目中常见因依赖未传递导致注解类不可见
- 检查切点表达式：如 @annotation(com.example.Idempotent) 中的包名是否拼写准确，是否与实际注解类路径一致
辅助诊断手段
光看代码容易漏细节，结合运行时信息更快定位。
- 启用 Spring AOP 调试日志：在 application.properties 加 logging.level.org.springframework.aop=DEBUG，观察代理创建过程
- 检查 Bean 生命周期：用 @PostConstruct 打印 this.getClass()，确认当前实例是否为代理类
- 临时换用 AspectJ 编译织入：添加 spring-aspects 依赖并启用 LTW，若此时注解生效，基本可锁定是 Spring AOP 代理机制限制所致
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
