Java Instrumentation 能在运行时修改类字节码，但仅限已加载类的 redefineClasses（仅替换方法体），真正自由插桩需通过 premain/agentmain + ClassFileTransformer 在加载前介入。
Java Instrumentation 能不能在运行时修改类字节码
能，但有严格限制：仅限于已加载类的重定义（redefineClasses），且只能替换方法体，不能增删字段、方法或修改签名。真正自由的插桩必须在类加载前介入，靠 premain 或 agentmain 配合 ClassFileTransformer 实现。
常见错误现象是调用 redefineClasses 后抛 UnsupportedOperationException 或 ClassNotFoundException——本质是 JVM 拒绝非法变更，不是代码写错了。
- 使用场景：APM 埋点、日志增强、性能采样（如慢方法记录）、测试覆盖率收集
- 关键约束：
transform方法返回的字节数组必须是合法的 class 文件格式，否则类加载直接失败，JVM 不会降级回退 - 字节码操作库推荐用
Byte Buddy或ASM，别手写十六进制；Javassist简单但容易在高版本 JDK 上因常量池处理不兼容而崩溃
premain 和 agentmain 的区别和选哪个
premain 在 JVM 启动时执行，能拦截所有后续类加载，适合全局埋点；agentmain 在运行时 attach，只能对尚未初始化的类生效（已初始化的类只能用 redefineClasses），适合热修复或按需开启监控。
容易踩的坑是误以为 agentmain 可以无差别重定义任意类——实际上，如果目标类已执行过 <clinit></clinit>（静态块），JVM 会拒绝重定义，报 java.lang.UnsupportedOperationException: class redefinition failed: attempted to change the schema (add/remove fields)，哪怕你没改 schema，只是字节码生成逻辑触发了 JVM 内部校验误判。
立即学习“Java免费学习笔记（深入）”；
-
premain必须通过-javaagent:path/to/agent.jar启动，无法动态追加 -
agentmain需要目标 JVM 开启Attach API（JDK 默认开，JRE 默认关），且依赖tools.jar或模块jdk.attach - 两者注册
ClassFileTransformer的方式一致，但agentmain下首次 transform 可能错过早期类（如java.lang.Object），得靠Instrumentation#getAllLoadedClasses+retransformClasses补漏
ClassFileTransformer.transform 方法里最常写的错
不是字节码改错，而是返回了 null 或原始字节数组却没做任何事——这会导致后续 transformer 链断裂，或者被 JVM 当作“未处理”，跳过你的逻辑。
另一个高频问题是没判断 classLoader 参数：系统类加载器（null）加载的核心类（如 java.util.ArrayList）默认禁止 transform，强行操作会触发 SecurityException；某些容器（如 Tomcat）还自定义类加载器，忽略 className 的包路径判断，导致插桩漏掉子模块。
- 必须检查
className是否为你关心的目标，用className.startsWith("com.example.")，别用contains - 若想处理 JDK 类，得先调用
instrumentation.appendToBootstrapClassLoaderSearch，且只对 JDK 8–16 有效；JDK 17+ 因强封装限制基本不可行 - transform 中抛异常不会 crash JVM，但该类本次加载失败，错误会吞掉——务必加 try-catch + 日志，否则问题静默失效
为什么本地调试 Instrumentation 总是不生效
因为 IDE（IntelliJ/Eclipse）启动 Java 进程时，不会自动把 agent jar 加入 classpath 或传递 -javaagent 参数，即使你在 Run Configuration 里写了，也常因路径含空格、相对路径解析失败或 jar 未 rebuild 而静默忽略。
更隐蔽的问题是 JVM 参数顺序：-javaagent 必须放在 -jar 之前，且不能和 -D 参数混在一起；用 java -XX:+PrintCommandLineFlags 可确认是否真传进去了。
- 验证是否加载成功：在
premain方法开头加System.out.println("Agent loaded")，并检查控制台首行输出 - 检查类是否被 transform：在
transform里打印className和classfileBuffer.length，确认目标类名拼写（注意内部类是com.example.Foo$Bar，不是com.example.Foo.Bar） - IDE 调试建议直接用命令行启动：
java -javaagent:/full/path/to/agent.jar -jar app.jar，绕过所有集成环境干扰
Instrumentation 的复杂点不在 API，而在 JVM 类加载阶段的不可见状态：类是否已初始化、是否被 bootstrap 加载、是否被其他 agent 先处理过——这些都无法从代码里直接读取，只能靠日志+条件断点+反复验证。
