不能直接用CtClass.toClass()创建带接口实现的代理类，因其默认使用上下文类加载器，与接口所在应用类加载器不一致，且未自动处理default方法、泛型签名及桥接方法，易引发NoClassDefFoundError、AbstractMethodError或泛型反射失败。
为什么不能直接用 CtClass.toClass() 创建带接口实现的代理类
因为 CtClass.toClass() 默认使用当前线程上下文类加载器（Thread.currentThread().getContextClassLoader()），而业务接口往往由应用类加载器（如 Spring Boot 的 LaunchedURLClassLoader）加载，两者不一致会导致 NoClassDefFoundError 或 VerifyError。更关键的是，Javassist 默认不会自动将接口的桥接方法、默认方法字节码一并生成，尤其当接口含 default 方法或泛型签名时，直接 addInterface() 后不手动补全方法体，运行期会抛 AbstractMethodError。
- 必须显式调用
ctClass.setClassLoader()指向目标接口所在类加载器 - 对每个
default方法，需用ctClass.addMethod(CtMethod.make(...))手动复制其字节码逻辑（不能只靠addInterface()） - 若接口含泛型（如
Service<t></t>），需同步设置ctClass.setGenericSignature()，否则反射获取泛型信息失败
如何正确注入业务逻辑：用 insertBefore() 还是重写整个 CtMethod
对已有接口方法注入逻辑，优先用 insertBefore() + insertAfter()，而非覆盖整个方法体。前者保留原始字节码结构，避免破坏异常表、局部变量表和行号信息；后者容易因手写字节码不匹配导致 StackOverflowError 或调试断点失效。
-
insertBefore("System.out.println(\"before: \" + $1);")中的$1是参数引用，$_是返回值占位符，注意类型匹配（如原始类型不能用$1.toString()） - 若需修改入参（如统一加 traceId），必须用
replace()并完整重写方法体，且要显式调用$proceed()，例如：replace("{ String newArg = injectTrace($1); $_ = $proceed(newArg); }") - 避免在
insertBefore()中 throw 异常后不 return —— Javassist 不校验控制流完整性，但 JVM 验证会失败
代理类命名与类加载冲突怎么绕过
动态类名重复（如多次生成 ProxyUserService）会导致 LinkageError，因为 JVM 不允许同一类加载器定义同名类两次。不能依赖随机后缀（如 ProxyUserService_123）解决，因为业务代码可能硬编码类名做 instanceof 判断。
- 推荐用接口全限定名 + 方法签名 MD5 做后缀，例如：
UserService$$Javassist$8a2f4c1d，确保相同逻辑生成唯一类名 - 调用
ctClass.toClass(ClassLoader, ProtectionDomain)时，传入接口的getClassLoader()，而不是null或系统类加载器 - 若需卸载类（如热更新场景），必须使用自定义类加载器并确保无静态引用泄漏，否则
OutOfMemoryError: Metaspace
遇到 CannotCompileException: by java.lang.NoClassDefFoundError: com/example/MyService 怎么定位
这不是类没找到，而是 Javassist 在编译时尝试解析 MyService 的父类/超接口，但其某个间接依赖（如 com.google.common.base.Optional）不在当前 classpath 下。Javassist 的解析是 eager 的，哪怕你只用到接口声明，它也会递归加载整个继承链。
立即学习“Java免费学习笔记（深入）”；
- 先检查
ctClass.getClassPool().insertClassPath(new ClassClassPath(MyService.class))是否已插入接口所在包路径 - 用
ctClass.debugWriteClass("/tmp/Proxy.class")导出字节码，再用javap -v查看Constant Pool中缺失的符号 - 对缺失的第三方类，手动添加其 jar 路径：
pool.insertClassPath("/path/to/guava.jar")，不要依赖 classpath 环境变量
