JavaAgent通过Instrumentation接口实现运行时字节码增强，核心是拦截类加载并修改字节码，支持premain启动时或agentmain运行时挂载；提供addClassTransformer（针对新加载类）和retransformClasses（刷新已加载类）两种方式，仅允许修改方法体，需注意限制与稳定性。
JavaAgent通过Instrumentation接口实现运行时字节码增强，核心在于拦截类加载过程并修改其字节码。它不依赖源码或重启，适用于监控、埋点、AOP等场景。
Instrumentation的获取与初始化
在JavaAgent中，premain或agentmain方法会收到一个Instrumentation实例，这是所有增强操作的入口：
-
premain：JVM启动时调用，需在META-INF/MANIFEST.MF中声明Premain-Class -
agentmain：运行时动态挂载，需声明Agent-Class并启用-javaagent或通过Attach API - 该接口不可自行构造，必须由JVM注入，且同一JVM中只存在一个实例
关键增强能力：retransformClasses与addClassTransformer
Instrumentation提供两类主流增强方式，适用不同阶段：
JavaStoryDevelop
下载
你接手一个需求时，是不是经常这样："改一个小字段 → 结果把不相关的代码也改了"、"需求说得很模糊 → 做着做着发现跑偏了"、"数据库加个字段 → 上线才发现漏了数据兼容"、"做了个新功能 → 一个月后自己都忘了当时怎么设计的"、"写到一半被中断 → 再回来不知道从哪继续"；这个 Skill 就是专门解决这些问题的。 它会自动探测你的项目环境（JDK、Spring Boot、ORM、数据库、前端框架），记在
-
addClassTransformer：注册
ClassFileTransformer，对后续新加载的类生效；支持过滤（如只处理指定包名），但对已加载类无效 -
retransformClasses：强制对已加载类重新触发transform流程；要求目标类此前已注册过transformer，且JVM需开启
-XX:+RetransformClasses - 两者常配合使用：先注册transformer，再调用
retransformClasses刷新老类，确保新旧实例行为一致
字节码修改的边界与限制
并非所有字节码变更都被允许，JVM对retransform和redefine有严格约束：
- 不能新增/删除字段或方法，不能修改方法签名、异常表或注解结构
- 仅允许修改方法体（method body）——即指令序列、局部变量表、栈帧大小等
- 若使用ASM、Byte Buddy等框架，应选用
ClassWriter(COMPUTE_FRAMES)或显式计算帧信息，避免VerifyError - 静态内部类、匿名类、Lambda生成类默认也会被增强，需在transformer中按
className主动过滤
常见实践建议
落地时需兼顾稳定性与可维护性：
- transformer中避免抛出未捕获异常，否则会导致整个类加载失败；建议用
try-catch包裹字节码修改逻辑并记录日志 - 对同一类多次retransform时，注意字节码是否已增强过，防止重复插入相同逻辑（如重复计时器）
- 利用
Instrumentation.isModifiableClass()提前校验类是否可修改，避免UnsupportedOperationException - 生产环境慎用
retransformClasses，尤其在高并发类加载场景下可能引发短暂停顿
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
