java agent 启动时修改的是 jvm 加载进内存前的字节码流，即 classloader.defineclass 前经 classfiletransformer 处理的原始字节码；常见错误源于签名不匹配、访问修饰符误改或字段未初始化，需正确注册 transformer 并注意类加载时机与栈图校验。
Java Agent 启动时修改字节码，到底改的是谁？
不是改源码，也不是改 .class 文件磁盘内容，而是改 JVM 加载进内存前的字节码流。JVM 在调用 ClassLoader.defineClass 之前，会把原始字节码交给已注册的 ClassFileTransformer 处理——你看到的“启动前修改”，其实发生在这个钩子上。
常见错误现象：NoClassDefFoundError 或 IllegalAccessError，往往是因为注入后方法签名不匹配、访问修饰符被误改，或新增字段没做 visitField 初始化。
- 必须在
premain或agentmain中调用Instrumentation.addTransformer，否则 transformer 不生效 - transformer 的
canRetransformClasses返回true才支持后续热重定义（如 Spring DevTools 场景） - 不要在 transformer 里直接 new 大对象或打日志——类加载阶段无可用 logger，且可能引发死锁
用 Byte Buddy 注入一个简单日志，为什么方法没被增强？
Byte Buddy 默认只处理“未加载过”的类；如果目标类在 agent 加载前已被系统类加载器提前加载（比如 java.lang.String 或 Spring 的早期核心类），ElementMatchers.any() 也抓不到它。
使用场景：想给所有 Controller 方法加入口日志，但发现部分接口没输出——大概率是这些类由 LaunchedURLClassLoader 提前加载了，而你的 agent transformer 还没注册完。
立即学习“Java免费学习笔记（深入）”；
- 确保
MANIFEST.MF包含Premain-Class: com.example.MyAgent和Can-Redefine-Classes: true - 用
ElementMatchers.nameStartsWith("com.example.web")替代宽泛匹配，避免误触 JDK 类 - 加一层
if (classBeingRedefined != null)判断，跳过已加载类的重复处理 - 示例中别写
.intercept(MethodDelegation.to(LogInterceptor.class))就完事——LogInterceptor必须能被 bootstrap classloader 访问，否则抛NoClassDefFoundError
java -javaagent 启动报错：Agent JAR not found or no premain method
不是路径写错，就是 MANIFEST.MF 格式不合规。JVM 要求 manifest 行末不能有空格，且必须以换行结尾（哪怕最后一行是空行）。
错误信息：Failed to find Premain-Class manifest attribute 或 java.lang.ClassNotFoundException: com.example.MyAgent 都指向同一问题：JVM 没识别出 agent 入口。
-
premain方法签名必须严格为public static void premain(String agentArgs, Instrumentation inst)，少一个参数或类型不对就失败 - JAR 包必须用
jar -cfm生成，不能用 IDE 直接导出（IDE 导出常漏 manifest 或编码为 UTF-8 BOM） - 路径中含中文或空格时，启动命令里
-javaagent:后面的路径要用英文双引号包裹，如-javaagent:"./my agent.jar"
修改 toString() 后单元测试崩了，是 ASM 操作太猛？
不是 ASM 猛，是你没处理好栈图（StackMapFrame）。Java 7+ 的 class 文件要求每个跳转指令后有正确的栈帧信息；手动用 ASM 插入字节码却没调 visitFrame，JVM 校验失败直接抛 VerifyError。
性能影响：过度增强 getter/setter 或 toString 方法，会导致 GC 压力上升——每次调用都新建 StringBuilder、触发字符串拼接，比原生实现慢 3–5 倍。
- 优先用 Byte Buddy 的
Advice（基于 ASM 的安全封装），它自动维护栈图；手写 ASM 仅用于极简 patch - toString 场景建议只增强特定注解类（如
@Loggable），而非全量拦截Object.toString - 若必须用 ASM，用
ClassWriter.COMPUTE_FRAMES模式构建 writer，让 ASM 自动计算帧，但会略增启动耗时
真正难的从来不是怎么插字节码，而是判断哪个类该改、改到什么粒度、以及改完之后会不会让另一个模块悄悄绕过你设的钩子——比如某个第三方 SDK 用 Unsafe.defineAnonymousClass 绕过 transformer。
