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提供两类主流增强方式，适用不同阶段：
Java注释规范Skills
下载
当用户要求为 Java 代码添加注释、修改注释、审查注释、整理注释格式，或要求按照代码注释规范处理 Java 文件时，使用本技能。本技能用于统一生成和维护 Java 类注释模板、按 Git 对比 release 判断版本号、补充每行代码上方中文块注释、调整注释空行规则，并保持 Java 文件 UTF-8 无 BOM 编码。典型触发场景包括：补充类注释、更新 @version、检查 @author 来源、整理行尾注释、把注释放到代码上一行、检查注释是否符合规范、构建前检查 Java 注释风格。
-
addClassTransformer：注册
ClassFileTransformer，对后续新加载的类生效；支持过滤（如只处理指定包名），但对已加载类无效 -
retransformClasses：强制对已加载类重新触发transform流程；要求目标类此前已注册过transformer，且JVM需开启
-XX:+RetransformClasses - 两者常配合使用：先注册transformer，再调用
retransformClasses刷新老类，确保新旧实例行为一致
字节码修改的边界与限制
并非所有字节码变更都被允许，JVM对retransform和redefine有严格约束：
立即学习“Java免费学习笔记（深入）”；
- 不能新增/删除字段或方法，不能修改方法签名、异常表或注解结构
- 仅允许修改方法体（method body）——即指令序列、局部变量表、栈帧大小等
- 若使用ASM、Byte Buddy等框架，应选用
ClassWriter(COMPUTE_FRAMES)或显式计算帧信息，避免VerifyError - 静态内部类、匿名类、Lambda生成类默认也会被增强，需在transformer中按
className主动过滤
常见实践建议
落地时需兼顾稳定性与可维护性：
- transformer中避免抛出未捕获异常，否则会导致整个类加载失败；建议用
try-catch包裹字节码修改逻辑并记录日志 - 对同一类多次retransform时，注意字节码是否已增强过，防止重复插入相同逻辑（如重复计时器）
- 利用
Instrumentation.isModifiableClass()提前校验类是否可修改，避免UnsupportedOperationException - 生产环境慎用
retransformClasses，尤其在高并发类加载场景下可能引发短暂停顿
