Java Agent只能在类加载前拦截并修改字节码，或通过retransformClasses重定义已加载类（需JVM支持且未被JIT锁定）；premain中addTransformer是唯一可靠拦截点，transform须返回非null字节码且避免耗时操作。
Java Agent 不能在“类加载前”真正意义上修改逻辑——它只能在类被 ClassLoader.defineClass 之前拦截字节码，然后返回修改后的 byte[]；所谓“加载后”增强，实际是靠 retransformClasses 触发已加载类的重新定义，前提是 JVM 支持且类未被 JIT 编译锁定。
premain 中 addTransformer 是唯一可靠的“加载前”拦截点
所有未加载的类，在首次被 ClassLoader 调用 defineClass 时，JVM 会同步调用已注册的 ClassFileTransformer.transform 方法。这是唯一能稳定介入字节码生成流程的位置。
-
transform方法必须返回非null的byte[]（哪怕原样返回），否则后续 transformer 可能收不到原始字节码 - 不要在
transform里做耗时操作（如网络请求、文件 I/O），它运行在类加载线程中，会阻塞整个应用启动或类首次使用 - 若目标类已被加载（比如
java.lang.String），transform不会被触发——此时必须走retransformClasses - 注意类名格式：参数
className是/分隔的内部形式（如com/example/Service），不是.分隔的全限定名
retransformClasses 能改已加载类，但有硬限制
调用 inst.retransformClasses(Service.class) 会让 JVM 对该类执行一次“重定义”，再次触发所有已注册的 transform 方法。但它不是万能的：
- 仅支持 JDK 6+ 且启动时加了
-XX:+UnlockDiagnosticVMOptions -XX:+ReinterpretCodeOnDemand（部分 JDK 版本还需-XX:+AllowEnhancedClassRedefinition） - JIT 已编译的方法无法重定义——如果类已被频繁调用，可能触发 C2 编译，此时
retransformClasses会直接抛UnsupportedOperationException - 不能新增/删除字段或方法签名，只能修改方法体（如插入字节码）、变更常量池项、调整注解值
- 必须确保
MANIFEST.MF中声明Can-Retransform-Classes: true，否则inst.isRedefineClassesSupported()返回false
多个 JavaAgent 共存时 transformer 执行顺序不可控
当用多个 -javaagent 启动（如同时挂载 SkyWalking 和自研探针），各 Agent 的 premain 按参数顺序执行，但它们注册的 transform 方法调用顺序由 JVM 内部决定，不保证与 addTransformer 调用顺序一致。
- 如果两个 Agent 都尝试增强同一个类（如
RestTemplate.execute），后执行的 transformer 收到的classfileBuffer可能已是被前一个 Agent 修改过的字节码 - 没有全局锁或版本协调机制，容易出现字节码校验失败（
VerifyError）或逻辑覆盖丢失 - 调试时建议用
inst.addTransformer(..., true)的重载方法开启canRetransform模式，并配合javap -c检查最终字节码是否符合预期
ASM 和 ByteBuddy 的选择直接影响开发效率和稳定性
直接手写字节码几乎不可行，必须依赖框架。ASM 更底层、性能高，但要求你熟悉 JVM 指令集；ByteBuddy 抽象层更高，API 更接近 Java 语法，但生成的字节码体积略大、启动期开销稍高。
- 用 ASM 时，
ClassWriter.COMPUTE_MAXS会自动计算栈帧大小，但某些复杂控制流（如异常表嵌套）仍需手动调用visitMaxs - 用 ByteBuddy 时，避免在
DynamicType.Builder链中多次调用method(ElementMatchers.any()).intercept(...)，这会导致重复织入；应合并为单次匹配 - 无论哪种框架，都必须测试 JDK 版本兼容性——ASM 9 支持 JDK 17+，但旧版 ASM 无法处理
sealed类或record的合成方法
真正难的不是“怎么加一行日志”，而是判断某个类是否已被 JIT 锁定、多个 transformer 如何协作不冲突、以及增强后是否引入隐式依赖（比如新增了对 java.instrument 包内类的引用却没做 bootstrap classloader 适配）。这些细节不出现在文档里，只在 ClassNotFoundException 或 IllegalAccessError 堆栈里露头。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
