怎么利用 CGLIB 的字节码增强技术实现对 final 类之外的所有类的方法拦截

风杰酱_4115

风杰酱_4115

2026-04-18

721人浏览

原创

cglib无法拦截final类或final方法,因其通过asm生成子类并重写方法实现拦截,而jvm禁止继承final类或覆盖final方法,导致类加载时报verifyerror或illegalargumentexception。

怎么利用 cglib 的字节码增强技术实现对 final 类之外的所有类的方法拦截

CGLIB 无法拦截 final 类或 final 方法——这不是配置问题,是字节码层面的硬性限制。只要目标类不是 final,且待拦截方法是非 final、非 private 的实例方法,CGLIB 就能通过子类继承 + 方法重写完成拦截。

为什么 final 类和 final 方法一定拦不住

CGLIB 的本质是用 ASM 动态生成目标类的子类,再在子类中重写目标方法,插入 MethodInterceptor.intercept() 调用。而 JVM 规范明确禁止子类覆盖 final 类或 final 方法——字节码校验器会在类加载阶段直接抛出 VerifyError 或运行时报 IllegalArgumentException: Cannot subclass final class。

常见错误现象包括:

  • 代理创建时抛 java.lang.IllegalArgumentException: Cannot subclass final class xxx
  • 调用代理对象方法时触发 java.lang.VerifyError: Illegal inheritance from final class
  • Spring 启动失败,日志里出现 “CGLIB enhancement failed” 并提示 final 相关关键词

使用 Enhancer 创建代理的最小可行路径

核心是正确设置 Enhancer 实例,并传入实现 MethodInterceptor 的回调。注意:不要用反射调用原方法(即别用 method.invoke()),必须走 MethodProxy.invokeSuper() 才能绕过反射开销、触发 CGLIB 的 FastClass 优化。

实操要点:

  • enhancer.setSuperclass(TargetClass.class):目标类不能是 final,否则立即失败
  • enhancer.setCallback(new MyInterceptor()):回调必须是 MethodInterceptor 实现,不能是 InvocationHandler
  • enhancer.create() 返回的是子类实例,类型是 TargetClass 的子类,不是接口代理
  • 拦截器中调用目标方法必须用 methodProxy.invokeSuper(obj, args),而非 method.invoke(obj, args)

示例片段:

睿信学术诚信平台
睿信学术诚信平台

睿信学术诚信平台是一款面向高校和期刊的AIGC学术诚信检测工具。

下载
Enhancer enhancer = new Enhancer();
enhancer.setSuperclass(Service.class); // Service 非 final
enhancer.setCallback((MethodInterceptor) (obj, method, args, proxy) -> {
    System.out.println("before " + method.getName());
    Object result = proxy.invokeSuper(obj, args); // 关键:走 CGLIB 快速路径
    System.out.println("after " + method.getName());
    return result;
});
Service proxy = (Service) enhancer.create();
proxy.publicMethod(); // ✅ 被拦截
// proxy.finalMethod(); // ❌ 编译不报错,但运行时不会进 intercept,也不会执行——因为该方法根本没被重写进代理类

如何提前发现不可代理的方法

CGLIB 不会为 final、static、private 方法生成重写逻辑,也不会报错提示——它们只是“静默跳过”。这意味着你写的 intercept() 根本不会被调用,容易误以为拦截失效。

验证方式:

  • 用 javap -c 反编译生成的代理类(类名类似 Service$$EnhancerByCGLIB$$xxx),检查对应方法是否含 invokeSuper 调用
  • 在 intercept() 开头加日志 + 断点,确认目标方法调用时是否进入该回调
  • 对关键方法显式添加单元测试:调用后检查日志/副作用是否发生

特别注意:toString()、hashCode()、equals(Object) 这些从 Object 继承的方法,默认会被 CGLIB 重写并拦截——除非你手动调用 enhancer.setUseFactory(false) 或禁用相关选项,否则它们属于“自动可拦截”范围。

兼容 JDK 代理的混合策略(避免踩坑)

如果你的代码要同时支持有接口和无接口的目标类,别强行统一用 CGLIB。更稳妥的做法是运行时判断:

  • 目标类实现了接口 → 优先用 Proxy.newProxyInstance()(JDK 代理)
  • 目标类无接口但非 final → 用 Enhancer(CGLIB)
  • 目标类是 final 或只有 final 方法 → 放弃动态代理,改用装饰器模式、编译期注解(如 AspectJ)或重构设计

Spring AOP 默认就按这个逻辑选型:@EnableAspectJAutoProxy(proxyTargetClass = false) 走 JDK,设为 true 才强制 CGLIB;但即使强制,遇到 final 类仍会 fallback 到 JDK 并报错——所以最终能否成功,还是取决于类定义本身。

最易被忽略的一点:CGLIB 生成的代理类默认没有无参构造器。如果目标类只有带参构造器,enhancer.create() 会抛 IllegalArgumentException。此时必须用 enhancer.setCallbacks() + enhancer.setConstructorArgs() 显式传参,否则代理创建直接失败。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

字节

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
java
java

Java是一个通用术语,用于表示Java软件及其组件,包括“Java运行时环境 (JRE)”、“Java虚拟机 (JVM)”以及“插件”。php中文网还为大家带了Java相关下载资源、相关课程以及相关文章等内容,供大家免费下载使用。

2023.06.15

10557

6

java正则表达式语法
java正则表达式语法

java正则表达式语法是一种模式匹配工具,它非常有用,可以在处理文本和字符串时快速地查找、替换、验证和提取特定的模式和数据。本专题提供java正则表达式语法的相关文章、下载和专题,供大家免费下载体验。

2023.07.05

7682

9

java自学难吗
java自学难吗

Java自学并不难。Java语言相对于其他一些编程语言而言,有着较为简洁和易读的语法,本专题为大家提供java自学难吗相关的文章,大家可以免费体验。

2023.07.31

6692

8

java配置jdk环境变量
java配置jdk环境变量

Java是一种广泛使用的高级编程语言,用于开发各种类型的应用程序。为了能够在计算机上正确运行和编译Java代码,需要正确配置Java Development Kit(JDK)环境变量。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.08.01

1144

3

java保留两位小数
java保留两位小数

Java是一种广泛应用于编程领域的高级编程语言。在Java中,保留两位小数是指在进行数值计算或输出时,限制小数部分只有两位有效数字,并将多余的位数进行四舍五入或截取。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.08.02

928

3

java基本数据类型
java基本数据类型

java基本数据类型有:1、byte;2、short;3、int;4、long;5、float;6、double;7、char;8、boolean。本专题为大家提供java基本数据类型的相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.02

1376

5

java有什么用
java有什么用

java可以开发应用程序、移动应用、Web应用、企业级应用、嵌入式系统等方面。本专题为大家提供java有什么用的相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.02

2769

5

java在线网站
java在线网站

Java在线网站是指提供Java编程学习、实践和交流平台的网络服务。近年来,随着Java语言在软件开发领域的广泛应用,越来越多的人对Java编程感兴趣,并希望能够通过在线网站来学习和提高自己的Java编程技能。php中文网给大家带来了相关的视频、教程以及文章,欢迎大家前来学习阅读和下载。

2023.08.03

20091

3

配置java环境变量
配置java环境变量

配置Java环境变量是为了让操作系统能够识别和使用Java的相关命令和功能。本专题为大家提供配置java环境变量相关文章,帮助大家解决问题。

2023.08.03

1235

8

热门下载

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

精品课程

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