CGLIB字节码代理实现无侵入切面

CGLIB通过动态生成目标类的非final子类来实现无接口依赖的字节码级代理，以MethodInterceptor插入切面逻辑，并借助MethodProxy.invokeSuper直接调用父类原方法规避反射开销与访问限制，在性能和适用性上显著优于JDK代理；但其能力受限于final类/方法、静态/私有成员、无参构造器等硬性约束，且在Spring AOP中仅当目标类完全不实现接口时才自动启用——理解这些底层机制与典型陷阱（如错误使用method.invoke导致栈溢出、类加载器冲突、缓存滥用等），是写出高效、稳定、可调试的无侵入切面的关键。

为什么 CGLIB 能代理没有接口的类

CGLIB 不依赖接口，而是通过 Enhancer 在运行时生成目标类的子类，重写所有非 final 方法，并在方法体中插入对 MethodInterceptor.intercept() 的调用。这意味着只要类不是 final，且方法不是 final 或 static，就能被拦截。

它不走反射调用目标方法（像 JDK 代理那样），而是用 MethodProxy.invokeSuper() 直接跳转到父类原方法，性能更高，也绕开了反射的访问控制检查。

• 必须有无参构造器（否则 Enhancer 创建子类实例会抛 IllegalArgumentException）
• final class、final method、private method、static method 全部无法代理 —— 这不是 bug，是字节码层面限制
• 若目标类构造器有参数或抛异常，需配合 Enhancer.setCallbackFilter() 和自定义 CallbackFilter 控制代理逻辑范围

如何写出一个可用的 MethodInterceptor 实现

核心是正确使用 MethodProxy，而不是直接反射调用 method.invoke()。后者会绕过 CGLIB 生成的子类逻辑，导致拦截失效或栈溢出。

典型错误写法：method.invoke(obj, args) —— 这会重新触发子类中被重写的方法，形成无限递归。

• 务必用 proxy.invokeSuper(obj, args) 调用原始方法
• obj 是子类实例，proxy 是 CGLIB 为该方法生成的委托句柄，二者必须匹配
• 如果需要获取目标类真实类型（比如做泛型判断），用 obj.getClass().getSuperclass()，而非 obj.getClass()
• 不要在 intercept() 中缓存 proxy 或 method 引用作跨请求复用 —— 它们是线程不安全的，且与具体代理实例绑定

Enhancer 配置的关键参数和陷阱

Enhancer 是 CGLIB 的入口类，但默认行为容易踩坑：比如没设 setSuperclass() 会报空指针，没设 setCallback() 会返回普通实例而非代理对象。

• enhancer.setSuperclass(UserService.class) —— 必须显式指定，不能传 null
• enhancer.setCallback(new UserServiceInterceptor()) —— 单回调模式；如需不同方法不同逻辑，用 setCallbacks() + setCallbackFilter()
• enhancer.setClassLoader(UserService.class.getClassLoader()) —— 显式指定类加载器，避免与 Spring 等框架冲突（尤其在模块化环境或 OSGi 下）
• 不建议调用 enhancer.setUseCache(true)（默认已开启），除非你确认代理类结构稳定；缓存失效会导致 OutOfMemoryError: Metaspace

Spring AOP 自动切换 CGLIB 的边界条件

Spring 并不会“优先”用 CGLIB。它的选择逻辑很明确：只要目标对象实现至少一个接口，就用 JDK 动态代理；只有当目标对象没有任何接口时，才 fallback 到 CGLIB。

这意味着：哪怕你写了 @EnableAspectJAutoProxy(proxyTargetClass = true)，如果目标类实现了接口，Spring 仍可能用 JDK 代理 —— 除非你强制关闭接口代理能力。

• 真正触发 CGLIB 的最小条件：target instanceof Serializable == false 且 target.getClass().getInterfaces().length == 0
• proxyTargetClass = true 只是“允许” Spring 使用 CGLIB，不是“强制”。是否启用还取决于目标类是否满足无接口条件
• Spring 内部用的是 ObjenesisCglibAopProxy，它包装了 Enhancer，但屏蔽了 setThreadCallbacks() 等底层能力 —— 如需精细控制（如多回调、延迟初始化），得脱离 Spring 自己 new Enhancer

CGLIB 的本质是“继承 + 字节码改写”，不是魔法。一旦你开始调试 intercept() 里的 obj 类型，或者看到生成的代理类名形如 UserService$$EnhancerByCGLIB$$a1b2c3d4，就说明它已在工作 —— 但 final 修饰符、类加载器隔离、构造器约束这些硬性边界，绕不开，也掩盖不了。

理论要掌握，实操不能落！以上关于《CGLIB字节码代理实现无侵入切面》的详细介绍，大家都掌握了吧！如果想要继续提升自己的能力，那么就来关注golang学习网公众号吧！