CGLIB 通过生成目标类的非 final 子类实现代理,核心组件为 Enhancer、MethodInterceptor 和 MethodProxy;它绕过 JDK 代理必须接口的限制,但要求目标类及方法不可为 final,构造器需 public/protected。

直接用 CGLIB 为没实现接口的类做代理,核心是让它生成一个继承该类的子类,并在重写方法时插入增强逻辑。它不依赖接口,而是靠字节码操作在运行时构造新类。
为什么必须用 CGLIB?
JDK 动态代理只能代理接口,目标类若没实现任何接口,Proxy.newProxyInstance 就会报错。CGLIB 绕过这个限制——它不靠接口实现,而是用 ASM 修改字节码,生成目标类的非 final 子类,把方法调用“劫持”到拦截器里。
- 目标类不能是 final 类(否则无法被继承)
- 要增强的方法也不能是 final 或 private(否则无法被重写)
- 构造器需为 public 或 protected(子类要能调用父类构造)
关键组件与基本流程
CGLIB 的主干是 Enhancer、MethodInterceptor 和 MethodProxy:
- Enhancer:代理生成器,负责设置父类、回调逻辑,最终调用 create() 得到代理实例
- MethodInterceptor:定义拦截行为,intercept() 方法中可处理前置、后置、异常逻辑
- MethodProxy:不是原生 Method 对象,而是 CGLIB 封装的高效调用方式,推荐用 proxy.invokeSuper() 调用父类原始方法(比 method.invoke() 快)
写一个可用的代理示例
假设有一个纯 POJO 类:
public class OrderService {public void submit(String orderId) {
System.out.println("提交订单:" + orderId);
}
}
添加 CGLIB 依赖(Maven):
创建代理:
Enhancer enhancer = new Enhancer();enhancer.setSuperclass(OrderService.class);
enhancer.setCallback((obj, method, args, proxy) -> {
System.out.println("[日志] 开始执行 " + method.getName());
Object result = proxy.invokeSuper(obj, args);
System.out.println("[日志] 执行完成");
return result;
});
OrderService proxy = (OrderService) enhancer.create();
proxy.submit("ORD-001");
输出会包含日志前缀和原始业务逻辑,说明增强已生效。
实际开发中的注意事项
CGLIB 在 Spring AOP 中是自动启用的后备方案:当目标 Bean 没有接口时,Spring 会悄悄切换到 CGLIB 代理。但手动使用时要注意:
- 避免对 final 类或方法使用,否则抛出 IllegalArgumentException
- 代理对象是目标类的子类,所以 instanceof 判断仍为 true(比如 proxy instanceof OrderService 返回 true)
- 如果目标类有带参构造器,需通过 enhancer.setCallbacks() 配合 ObjectsFactory 设置构造参数
- Spring Boot 3+ 默认已内置 CGLIB,无需额外引入,但老项目需确认版本兼容性

















