Java Agent扩展调用Spring Boot依赖类时ClassNotFoundException问题咨询

问题原因 #

Spring Boot可执行Jar采用分层结构，BOOT-INF/lib下的依赖默认仅能被Spring Boot的应用类加载器（LaunchedURLClassLoader）访问，而Java Agent扩展通常使用系统类加载器或自身类加载器，因此无法找到client-library中的类。

解决方案 #

方案1：将client-library打包到Java Agent扩展Jar中 #

把client-library的依赖直接合并到你的Agent扩展Jar里，确保Agent扩展的类加载器能直接访问该类。可以用Maven的maven-shade-plugin实现：

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-shade-plugin</artifactId>
    <version>3.4.1</version>
    <executions>
        <execution>
            <phase>package</phase>
            <goals>
                <goal>shade</goal>
            </goals>
            <configuration>
                <artifactSet>
                    <includes>
                        <include>你的client-library坐标</include>
                    </includes>
                </artifactSet>
            </configuration>
        </execution>
    </executions>
</plugin>

方案2：启用Spring Boot全局类路径参数 #

添加-Dspring.boot.classpath=all启动参数，让Spring Boot将BOOT-INF/lib和BOOT-INF/classes的内容全部加入系统类加载器的类路径，使Agent扩展能通过系统类加载器找到目标类。修改后的启动命令示例：

java -javaagent:"opentelemetry-javaagent-1.15.0.jar" \
-Dotel.resource.attributes=***** \
-Dotel.service.name=**** \
-Dotel.traces.exporter=**** \
-Dotel.metrics.exporter=**** \
-Dotel.javaagent.enabled=true \
-Dcontrast.agent.java.standalone_app_name=***** \
-Dotel.javaagent.extensions="otel-agent-ext-java-1.2.49-m3.jar" \
-Dspring.boot.classpath=all \
-jar 你的Spring Boot应用.jar

方案3：使用Spring Boot PropertiesLauncher #

修改Spring Boot打包配置，指定使用PropertiesLauncher，它会将BOOT-INF/lib的Jar作为扩展类路径加载，让系统类加载器可访问：

<plugin>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-maven-plugin</artifactId>
    <configuration>
        <layout>ZIP</layout> <!-- 对应PropertiesLauncher -->
    </configuration>
</plugin>

打包后直接用java -jar启动即可，无需额外参数（若需要自定义路径，可添加-Dloader.path参数）。

方案4：在Agent扩展中使用Spring Boot应用类加载器加载类 #

修改Agent扩展的Class.forName调用逻辑，使用Spring Boot应用的上下文类加载器来加载目标类：

// 获取Spring Boot应用类加载器
ClassLoader appClassLoader = Thread.currentThread().getContextClassLoader();
// 通过应用类加载器加载client-library中的类
Class<?> targetClass = Class.forName("com.your.client.TargetClass", true, appClassLoader);

内容的提问来源于stack exchange，提问作者Praveen Kumar