java agent的premain不执行主因是jvm未正确加载代理，需通过-javaagent指定jar路径且manifest.mf中声明premain-class；-javaagent必须置于java命令最前，manifest文件不能含bom或多余空行。
Java Agent 启动时 premain 方法不执行？检查 JVM 参数和 MANIFEST.MF
根本原因往往不是代码写错，而是代理没被 JVM 正确加载。JVM 必须显式通过 -javaagent 参数指定 jar 路径，且该 jar 的 META-INF/MANIFEST.MF 中必须声明 Premain-Class（注意大小写），否则 premain 根本不会进 JVM 的调用链。
常见错误现象：ClassNotFoundException 报的是你的代理类名，或者完全静默无日志——说明 JVM 压根没尝试加载它。
-
-javaagent:/path/to/your-agent.jar必须放在java命令的最前面，不能塞在-jar xxx.jar之后 -
META-INF/MANIFEST.MF里不能有多余空行或 UTF-8 BOM；Premain-Class: com.example.MyAgent后面要跟一个空行 - 如果用 Maven 构建，推荐用
maven-jar-plugin配置archive+manifestEntries，别手动改 MANIFEST
想在运行时修改类？Instrumentation.retransformClasses() 不是万能的
这个方法只能重转换已加载且未被 defineClass 锁定的类，而且前提是目标类没被 JVM 内联过、没被 JIT 编译成不可逆的 native code。很多线上环境开了 -XX:+TieredStopAtLevel=1 或禁用 JIT，就是为了保重转换成功率。
使用场景很窄：适合监控类（比如加埋点）、简单字段访问拦截，不适合大改逻辑结构（如增删方法、改继承关系）。
立即学习“Java免费学习笔记（深入）”；
- 调用前必须先
instrumentation.addTransformer(transformer, true)，第二个参数true表示支持重转换 - 每个
ClassFileTransformer的transform()方法返回null表示不修改；返回新字节数组时，必须保证常量池、属性表等结构合法，否则抛ClassFormatError - 对同一个类反复调用
retransformClasses()可能触发多次transform()，但 JVM 不保证顺序，别依赖执行次数做状态判断
用 ByteBuddy 改字节码，为什么 MethodDelegation 到静态方法后拿不到原始参数？
因为 MethodDelegation.to(YourClass.class) 默认只传入目标方法签名，不自动注入 @SuperCall、@This 这些上下文。你看到的“参数丢失”，其实是代理逻辑没显式声明如何桥接。
性能影响不大，但写错会导致 NullPointerException 或逻辑跳过——尤其在监控场景下，漏埋点比报错更难排查。
- 要在委托方法上用
@RuntimeType注解，并把参数类型严格对齐原方法，包括Object[] args或逐个声明 - 如果想复用原方法逻辑，必须显式加
@SuperCall Callable<object> zuper</object>参数，再手动调用zuper.call() - 避免在委托方法里做耗时操作（如远程调用、IO），它会卡住目标方法执行线程；监控类建议异步发事件，别阻塞
热插拔后内存泄漏？小心 ClassLoader 引用链没断
代理修改过的类，其 Class 对象仍由原始 ClassLoader 加载，但如果你在 transformer 里 new 出了新对象并长期持有（比如存进 static Map），又没清理，就容易让整个 ClassLoader 无法回收——特别是 Web 容器里频繁 reload 应用时。
这不是 Java Agent 特有问题，但 agent 因为生命周期长、作用域广，更容易暴露出来。
- 别在 transformer 外部缓存
Class、Method或任何关联到被增强类的对象 - 如果必须缓存，用
WeakReference包一层，或监听ClassUnloadEvent（需开启-XX:+UnlockDiagnosticVMOptions -XX:+LogVMOutput，生产慎用） - 用
jcmd <pid> VM.native_memory summary</pid>或jmap -clstats <pid></pid>查看类加载器实例数变化，比看堆内存更早发现问题
真正麻烦的从来不是怎么改字节码，而是改完之后，谁还在引用它、谁在偷偷 hold 住 ClassLoader、谁把异常吞掉了还假装成功。
