能否将javaagent jar包作为pom.xml依赖引入而非通过-javaagent参数指定

完全可以跳过-javaagent启动参数，通过普通Maven依赖引入的方式加载Java Agent，目前生产环境有两种成熟的落地路径：

方案1：基于JVM Attach API实现运行时自加载 #

这是适配字节码增强类Agent的通用方案，不需要修改任何启动命令，仅需在应用初始化最早阶段触发Agent自挂载即可。

• 核心依赖：直接使用JDK自带的com.sun.tools.attach.VirtualMachine能力，JDK8及以下默认可用，JDK9+需声明对应模块依赖
• 实现流程：
  • 获取当前运行JVM的进程ID
  • 解析当前Agent jar包在磁盘上的真实绝对路径
  • 调用Attach API挂载Agent，触发Agent的agentmain入口执行
• 参考实现代码：

import com.sun.tools.attach.VirtualMachine;
import java.lang.management.ManagementFactory;

public class AgentBootstrap {
    // 加加载标记防止重复挂载
    private static volatile boolean loaded = false;

    public static synchronized void init() throws Exception {
        if (loaded) {
            return;
        }
        // 获取当前JVM PID
        String runtimeName = ManagementFactory.getRuntimeMXBean().getName();
        String pid = runtimeName.split("@")[0];
        // 解析Agent jar的真实磁盘路径
        String agentJarPath = AgentBootstrap.class.getProtectionDomain()
                .getCodeSource().getLocation().toURI().getPath();
        // 执行挂载
        VirtualMachine vm = VirtualMachine.attach(pid);
        try {
            vm.loadAgent(agentJarPath);
            loaded = true;
        } finally {
            vm.detach();
        }
    }
}

• 适配要求：
  • Agent类中除常规premain方法外，必须额外实现public static void agentmain(String agentArgs, Instrumentation inst)方法，内部逻辑和premain保持一致，动态挂载流程会走agentmain入口
  • 将AgentBootstrap类放在Agent jar包的公共可访问路径下，业务应用引入依赖后，在启动最早期节点（比如启动类main方法第一行、Spring容器初始化前置拦截点）调用AgentBootstrap.init()即可完成加载
  • JDK9+版本需在Agent jar的module-info.java中声明对jdk.attach模块的依赖；JDK8纯JRE环境若缺失tools.jar，打包时可将Attach相关类shade进Agent jar，避免类找不到报错

方案2：Agent初始化逻辑与普通依赖初始化打通 #

如果你的Agent不需要Instrumentation提供的字节码修改、类重转换等特殊能力，完全可以跳过Attach流程，直接把初始化逻辑封装为普通公共方法。

• 适用场景：仅做JVM指标采集、日志埋点、简单调用链统计这类不需要修改字节码的轻量Agent需求
• 实现方式：把原本写在premain里的初始化逻辑抽成公共静态方法，业务方引入依赖后直接调用方法完成初始化即可，不需要处理PID解析、路径适配、Attach权限等问题，接入成本极低

• 路径解析不要硬编码：必须通过类加载器获取Agent jar的真实磁盘路径，否则在容器部署、Spring Boot fat jar、IDE运行等场景下大概率出现找不到jar的问题
• 类加载器隔离问题：Spring Boot等fat jar部署场景下，要确保Agent相关类能被启动类加载器加载，避免出现类转换异常、Instrumentation实例不共享的问题
• 重复加载防护：一定要加加载状态标记，避免业务方多次调用初始化方法导致Agent重复挂载、逻辑重复执行

内容的提问来源于stack exchange，提问作者Jacob Selvaraj