java agent探针是jvm启动时加载的独立jar包，通过java.lang.instrument机制拦截类加载、修改字节码、收集运行时数据，本质是jvm提供的“钩子”。
Java Agent探针到底是什么
它不是插件，也不是SDK，而是一个在JVM启动时加载的独立Jar包，通过java.lang.instrument机制，在不修改业务代码的前提下，拦截类加载、修改字节码、收集运行时数据。本质是JVM提供的“钩子”，不是应用自己写的逻辑。
常见错误现象：NoClassDefFoundError: java/lang/instrument/Instrumentation（用JRE而非JDK运行）、Agent JAR not found or no Agent-Class manifest attribute（Jar包缺MANIFEST.MF声明）。
使用场景：APM监控（如SkyWalking、Pinpoint）、代码覆盖率（JaCoCo）、热更新（JRebel）、日志增强、安全审计。
-javaagent参数怎么写才生效
必须放在java命令的**主类或-jar之前**，且每个Agent需单独一个-javaagent。顺序错、路径错、空格错都会静默失败（JVM不报错但Agent不加载）。
立即学习“Java免费学习笔记（深入）”；
无序列表：
-
-javaagent:/path/to/agent.jar：最简形式，要求Jar包MANIFEST.MF里有Agent-Class: com.example.MyAgent -
-javaagent:/path/to/agent.jar=arg1,arg2：等号后内容传给premain(String, Instrumentation)的agentArgs参数，注意不要带空格 - 路径必须是绝对路径，或相对于当前工作目录的相对路径；不能用
~或环境变量（如$HOME） - 多个Agent按从左到右顺序加载，后加载的Agent能看到前一个已修改过的字节码
为什么加了-javaagent却没看到探针效果
90%的情况不是配置错，而是Agent本身没做对三件事：没注册类转换器、没匹配到目标类、没正确处理重定义限制。JVM默认禁止对已加载类的字节码重写（retransform），而很多探针依赖这个能力。
关键检查点：
- 确认JVM启用了
-XX:+EnableDynamicAgentLoading（JDK 9+ 默认开启，但某些容器镜像会关掉） - Agent中是否调用
inst.addTransformer(..., true)并传true启用retransform支持 - 是否在
premain里就注册了ClassFileTransformer，而不是等到运行时才动态注册 - 目标类是否已被Bootstrap ClassLoader加载（如
java.util.ArrayList），这类类无法被普通Agent修改
示例错误配置：java -javaagent:skywalking-agent.jar -jar app.jar → 正确；java -jar app.jar -javaagent:skywalking-agent.jar → 完全无效，JVM直接忽略。
Agent Jar包必须满足什么结构
不是随便打包就能用。JVM只认MANIFEST.MF里的两个关键字段，缺一不可，且大小写敏感。
必须包含：
Manifest-Version: 1.0-
Agent-Class: com.example.MyAgent（对应premain入口类）
可选但常用：
-
Can-Redefine-Classes: true（允许 redefine） -
Can-Retransform-Classes: true（允许 retransform） -
Can-Set-Native-Method-Prefix: true（用于Native方法拦截）
容易踩的坑：用jar cvf直接打包.class文件却不生成MANIFEST.MF；或用IDE导出Jar时没勾选“save as executable jar”导致MANIFEST丢失；或字段名拼错成Agent_class（下划线）或agent-class（小写）。
验证方式：jar -xf agent.jar META-INF/MANIFEST.MF && cat META-INF/MANIFEST.MF
真正难的不是加参数，而是理解Agent生命周期和JVM类加载隔离——比如同一个类被不同ClassLoader加载多次，你的Transformer可能只命中其中一次。这点常被文档跳过，但线上排查时最耗时间。
