java agent + asm 能满足生产环境方法耗时审计的三大硬约束，前提是严格规避翻车点：premain 必须正确注册 classfiletransformer 并声明 manifest.mf 中的 premain-class 和 can-retransform-classes；transform 方法需轻量判断、禁用日志/对象创建/外部调用；asm 插桩须用 system.nanotime()、严格匹配 descriptor、无锁上报；已加载类必须显式 retransform。
生产环境方法耗时审计必须满足三个硬约束：不拖慢启动、不卡住类加载、不引发 GC 尖刺。Java Agent + ASM 能做到，但前提是绕开所有常见翻车点。
premain 里没注册 transformer 就等于没写 Agent
Agent 启动后完全没反应？第一反应不是查日志，而是确认 premain 方法是否真的执行了，并且调用了 instrumentation.addTransformer。JVM 只在满足两个 MANIFEST.MF 条件时才会调用 premain：
-
Premain-Class: com.example.MyAgent—— 缺失或拼错类名，premain根本不会进 -
Can-Retransform-Classes: true—— 想对 Spring Controller 这类早于 Agent 加载的类做增强，这个必须设为true，否则retransformClasses直接抛UnsupportedOperationException
另外，premain 方法签名必须是 public static void premain(String agentArgs, Instrumentation inst)，少一个参数或类型不对，JVM 会静默忽略。
transform 方法里不能打日志、不能 new 对象、不能调远程
ClassFileTransformer.transform 是类加载关键路径上的钩子，所有类（包括 java.lang.*）都会经过它。这里一卡，整个应用启动就 hang 住。常见错误包括：
- 在
transform里直接用System.out.println或 slf4j 打日志 —— 日志框架本身依赖大量类，可能触发递归加载 - 创建新对象（比如 new HashMap）、触发类初始化（比如访问静态字段）—— 增加 GC 压力和类加载竞争
- 调用外部服务、读配置文件、连 DB —— 网络超时或锁等待会直接卡死 JVM 启动
正确做法是只做轻量判断：用字符串匹配 className（如 "com/example/OrderService"），再检查 methodName 和 methodDesc（如 "processOrder(Lcom/example/Order;)V"），匹配成功才交给 ASM 处理，其余一律返回 null。
ASM 插入计时逻辑必须用 System.nanoTime() + 无锁上报
插桩位置和时间测量方式决定数据可信度：
- 入口插在
visitCode后，压入System.nanoTime()结果到栈顶；出口插在每个visitInsn遇到IRETURN/LRETURN/ARETURN/RETURN前，取差值并上报 - 绝对不要用
System.currentTimeMillis()—— 它受系统时钟跳变影响，NTP 校准后可能出现负耗时 - 上报逻辑必须是 lock-free 的：比如用
ThreadLocal缓存耗时数据，由独立线程批量 flush 到内存队列；或者直接写 ring buffer，避免 synchronized 或ConcurrentLinkedQueue的 CAS 争用
注意 descriptor 必须严格匹配：String 参数是 "Ljava/lang/String;"，数组是 "[Ljava/lang/String;"，少一个分号或斜杠，ASM 会跳过方法或抛 IllegalArgumentException。
已加载类必须手动 retransform，否则插桩不生效
Spring Bean、Controller、Mapper 接口实现类，99% 在 Agent 初始化前就完成了加载。这时 transform 根本不会被触发。解决方案只有一步：
在 premain 最后，调用 instrumentation.retransformClasses(classesToEnhance)，其中 classesToEnhance 来自 instrumentation.getAllLoadedClasses() 的遍历过滤结果。注意：retransformClasses 不会重新触发 transform，它走的是另一条重定义路径，所以你的 ClassFileTransformer 必须支持 canRetransform = true 场景，且内部要能识别重入场景（比如通过 classBeingRedefined != null 判断）。
真正难啃的是字节码兼容性：JDK 升级后某些指令语义变化（比如 invokedynamic 栈帧处理），或目标方法用了 Lombok 生成代码导致 descriptor 不稳定。这些没法靠配置绕过，得靠真实类做 smoke test。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
