Instrumentation API是JDK提供的标准API（java.lang.instrument），由JVM在启动或运行时注入Agent后自动提供实例，核心能力是在类加载时通过ClassFileTransformer拦截字节码，或对已加载类调用retransformClasses进行重定义，从而实现无源码修改的运行时增强。
Java Agent 通过 Instrumentation API 实现运行时字节码增强，无需修改源码、不重启 JVM，就能动态修改类行为——核心在于 类加载阶段的字节码拦截与重定义。
什么是 Instrumentation API？
Instrumentation 是 JDK 提供的标准 API（java.lang.instrument），由 JVM 在启动时或运行时注入 agent 后自动提供实例。它允许程序在类被加载（ClassFileTransformer）或已加载后（retransformClasses）介入字节码，是 Java Agent 的能力基础。
关键能力包括：
- 注册字节码转换器，在类加载时修改字节码（
addTransformer(transformer, true)） - 对已加载类重新定义（
retransformClasses(clazz...)），触发 JVM 再次调用已注册的 transformer - 获取类原始字节码（
getOriginalClassFileBuffer()），便于做增量修改 - 支持本地方法重定义（需开启
-XX:+EnableDynamicAgentLoading，JDK 9+ 默认支持）
如何编写一个可热插拔的 Java Agent？
实现分三步：写 agent 类、打包为 jar、运行时挂载。重点在于 premain 或 agentmain 中获取 Instrumentation 实例并注册 transformer。
立即学习“Java免费学习笔记（深入）”；
示例（运行时 attach 场景）：
- 定义
agentmain方法，接收Instrumentation参数 - 使用
ByteBuddy或ASM编写ClassFileTransformer，匹配目标类（如MyService），在其方法前插入日志逻辑 - 调用
inst.retransformClasses(MyService.class)触发重定义 - 确保 agent jar 的
META-INF/MANIFEST.MF包含：Agent-Class: com.example.MyAgentCan-Retransform-Classes: trueCan-Redefine-Classes: true
“热插拔”成功的关键限制与避坑点
不是所有修改都能生效。JVM 对 retransform 有严格约束：
- 仅允许修改方法体（method body），不能增删字段、方法、签名，也不能改变继承关系
- 新增的字节码不能引入新类（除非该类已加载），否则抛
ClassNotFoundException - 若类已被 JIT 编译，重定义后需等下次方法调用才生效（JVM 会失效原有编译代码）
- 某些框架（如 Spring CGLIB 代理类）可能绕过标准类加载路径，需确认目标类是否真实由
ClassLoader加载并可被retransform - 多线程环境下，建议在 transformer 中加锁或使用线程安全字节码库（如 ByteBuddy 的
make()是线程安全的）
常见落地场景与工具链推荐
真实项目中，这类能力常用于：
- 无侵入式监控：自动为 Controller 方法添加耗时埋点（Arthas、SkyWalking 的 trace 机制底层即如此）
- 灰度逻辑热替换：运行时切换某个服务的实现策略（如用
Unsafe.defineAnonymousClass动态生成策略类并替换字段值） - 故障模拟：临时给数据库连接池添加延迟或异常（如
HikariCP.getConnection()插入Thread.sleep(2000)） - 推荐组合：
• 字节码操作：ByteBuddy（API 友好）或 ASM（性能极致）
• 运行时 attach：使用com.sun.tools.attach.VirtualMachine或 Arthas 的attach命令
• 调试验证：JDK 自带jcmd <pid> VM.native_memory summary+javap -c查看修改后字节码
