0

0

如何在Java中使用CGLIB动态代理_MethodInterceptor与字节码增强技术

P粉602998670

P粉602998670

发布时间:2026-03-15 15:11:26

|

732人浏览过

|

来源于php中文网

原创

根本原因是目标类或方法被final修饰导致CGLIB无法继承生成子类,抛出IllegalArgumentException;需移除final、private、static修饰,并正确配置Enhancer的setSuperclass和setCallback,调用proxy.invokeSuper而非method.invoke。

如何在java中使用cglib动态代理_methodinterceptor与字节码增强技术

为什么 MethodInterceptor 代理后方法不执行?

根本原因通常是目标类或方法被 final 修饰,CGLIB 无法生成子类覆盖。CGLIB 基于继承实现代理,遇到 final classfinal method 会直接抛 IllegalArgumentException,而不是静默失败。

  • 检查被代理类是否加了 final —— 必须去掉
  • 确认方法没被 privatestatic 修饰(CGLIB 不支持)
  • 若用 Spring,注意 @EnableAspectJAutoProxy(proxyTargetClass = true) 才启用 CGLIB,否则默认 JDK 动态代理(只代理接口)
  • 常见错误现象:java.lang.IllegalArgumentException: Cannot subclass final class com.example.ServiceImpl

如何正确配置 Enhancer 并设置 MethodInterceptor

Enhancer 是 CGLIB 的核心入口,但它的链式调用容易漏掉关键步骤:必须显式指定父类(setSuperclass)和回调(setCallback),且 create() 不能带参数除非已定义构造器匹配。

  • enhancer.setSuperclass(YourClass.class) —— 必须,不能是 Object.class 或接口
  • enhancer.setCallback(new MethodInterceptor() { ... }) —— 回调对象必须实现 intercept(),且内部要调用 method.invokeSuper()(不是 method.invoke()
  • 如果目标类有带参构造器,需用 enhancer.setCallbacks(...) + enhancer.setCallbackFilter(...) 配合,否则 create()NoClassDefFoundError
  • 示例关键片段:
    Enhancer enhancer = new Enhancer();
    enhancer.setSuperclass(Service.class);
    enhancer.setCallback((MethodInterceptor) (obj, method, args, proxy) -> {
        System.out.println("before");
        Object result = proxy.invokeSuper(obj, args); // 注意是 invokeSuper
        System.out.println("after");
        return result;
    });
    Service proxy = (Service) enhancer.create();

CGLIB 代理与 JDK 动态代理的兼容性差异

两者机制不同,导致行为差异明显:CGLIB 代理的是类,JDK 代理的是接口。一旦混用(比如 Spring 中部分 Bean 走 JDK、部分走 CGLIB),就容易出现类型转换失败或 AOP 失效。

Winston AI
Winston AI

强大的AI内容检测解决方案

下载
  • 代理对象类型:CGLIB 返回的是子类实例(如 ServiceImpl$$EnhancerByCGLIB$$123456),instanceof ServiceImpltrue;JDK 返回的是接口实现,instanceof ServiceImplfalse
  • 性能上,CGLIB 首次生成字节码较慢(缓存后无感),但方法调用开销略高于 JDK 代理(多一次 invokeSuper 跳转)
  • Spring 默认策略:有接口 → JDK 代理;无接口 → CGLIB。可通过 spring.aop.proxy-target-class=true 强制统一为 CGLIB
  • 注意:CGLIB 依赖 net.sf.cglib:cglib,而 Spring 5.0+ 已内置 org.springframework:spring-core 中的精简版,无需额外引包,但版本不匹配仍可能报 NoSuchMethodError

字节码增强后常见的运行时异常

CGLIB 在运行时生成类,出错往往在类加载阶段,堆栈信息短、定位难。最常踩的坑是类路径污染或 ASM 版本冲突。

立即学习Java免费学习笔记(深入)”;

  • java.lang.VerifyError: Expecting a stackmap frame —— 多见于 Java 8+ 使用旧版 CGLIB(cglib-nodep:3.3.0 或更高
  • java.lang.NoClassDefFoundError: org/objectweb/asm/Type —— 表明 ASM 缺失或版本不兼容,CGLIB 3.x 依赖 ASM 7+,别混入 ASM 5.x 的 jar
  • 使用 Lombok 的 @AllArgsConstructor@RequiredArgsConstructor 时,CGLIB 可能因找不到匹配构造器而失败,建议显式定义无参构造器
  • 代理 Spring 管理的 Bean 时,若该 Bean 被 @Transactional@Async 修饰,确保代理类能被 Spring 容器识别(避免手动 new Enhancer()
CGLIB 的本质是“偷偷造个子类”,所有限制都来自 JVM 类加载和继承规则。真正麻烦的不是写几行代理代码,而是当它和 Spring、Lombok、模块化(JPMS)或者 GraalVM 混在一起时,那些不报错但逻辑突然失效的瞬间。

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

WorkBuddy
WorkBuddy

腾讯云推出的AI原生桌面智能体工作台

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
spring框架介绍
spring框架介绍

本专题整合了spring框架相关内容,想了解更多详细内容,请阅读专题下面的文章。

161

2025.08.06

Java Spring Security 与认证授权
Java Spring Security 与认证授权

本专题系统讲解 Java Spring Security 框架在认证与授权中的应用,涵盖用户身份验证、权限控制、JWT与OAuth2实现、跨站请求伪造(CSRF)防护、会话管理与安全漏洞防范。通过实际项目案例,帮助学习者掌握如何 使用 Spring Security 实现高安全性认证与授权机制,提升 Web 应用的安全性与用户数据保护。

89

2026.01.26

硬盘接口类型介绍
硬盘接口类型介绍

硬盘接口类型有IDE、SATA、SCSI、Fibre Channel、USB、eSATA、mSATA、PCIe等等。详细介绍:1、IDE接口是一种并行接口,主要用于连接硬盘和光驱等设备,它主要有两种类型:ATA和ATAPI,IDE接口已经逐渐被SATA接口;2、SATA接口是一种串行接口,相较于IDE接口,它具有更高的传输速度、更低的功耗和更小的体积;3、SCSI接口等等。

1974

2023.10.19

PHP接口编写教程
PHP接口编写教程

本专题整合了PHP接口编写教程,阅读专题下面的文章了解更多详细内容。

679

2025.10.17

php8.4实现接口限流的教程
php8.4实现接口限流的教程

PHP8.4本身不内置限流功能,需借助Redis(令牌桶)或Swoole(漏桶)实现;文件锁因I/O瓶颈、无跨机共享、秒级精度等缺陷不适用高并发场景。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2406

2025.12.29

java接口相关教程
java接口相关教程

本专题整合了java接口相关内容,阅读专题下面的文章了解更多详细内容。

49

2026.01.19

堆和栈的区别
堆和栈的区别

堆和栈的区别:1、内存分配方式不同;2、大小不同;3、数据访问方式不同;4、数据的生命周期。本专题为大家提供堆和栈的区别的相关的文章、下载、课程内容,供大家免费下载体验。

448

2023.07.18

堆和栈区别
堆和栈区别

堆(Heap)和栈(Stack)是计算机中两种常见的内存分配机制。它们在内存管理的方式、分配方式以及使用场景上有很大的区别。本文将详细介绍堆和栈的特点、区别以及各自的使用场景。php中文网给大家带来了相关的教程以及文章欢迎大家前来学习阅读。

606

2023.08.10

TypeScript类型系统进阶与大型前端项目实践
TypeScript类型系统进阶与大型前端项目实践

本专题围绕 TypeScript 在大型前端项目中的应用展开,深入讲解类型系统设计与工程化开发方法。内容包括泛型与高级类型、类型推断机制、声明文件编写、模块化结构设计以及代码规范管理。通过真实项目案例分析,帮助开发者构建类型安全、结构清晰、易维护的前端工程体系,提高团队协作效率与代码质量。

69

2026.03.13

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Kotlin 教程
Kotlin 教程

共23课时 | 4.4万人学习

C# 教程
C# 教程

共94课时 | 11.4万人学习

Java 教程
Java 教程

共578课时 | 82.7万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号