Spring Boot动态加载运行时依赖失败问题求助

问题根源 #

Spring Boot采用LaunchedURLClassLoader作为启动类加载器，它的类搜索逻辑和普通Java程序的ClassLoader不同。如果你用独立的URLClassLoader加载动态依赖，Spring的上下文初始化会提前扫描类路径，此时这些动态类还没被Spring的类加载器感知，就会抛出ClassNotFoundException。

具体解决步骤 #

1. 复用Spring Boot的类加载器 #

不要用自定义URLClassLoader隔离依赖，而是直接把下载的JAR注入到Spring Boot的启动类加载器中：

public static void addJarsToSpringClassLoader(List<File> downloadedJars) throws Exception {
    // 获取Spring Boot的上下文类加载器
    LaunchedURLClassLoader springClassLoader = (LaunchedURLClassLoader) Thread.currentThread().getContextClassLoader();
    // 反射调用URLClassLoader的protected方法addURL
    Method addUrlMethod = URLClassLoader.class.getDeclaredMethod("addURL", URL.class);
    addUrlMethod.setAccessible(true);
    
    // 批量添加下载的JAR包
    for (File jar : downloadedJars) {
        addUrlMethod.invoke(springClassLoader, jar.toURI().toURL());
    }
}

2. 调整启动顺序 #

必须在Spring上下文初始化之前完成依赖下载和类加载器注入，修改主类启动逻辑：

public static void main(String[] args) throws Exception {
    // 1. 用Apache Aether下载所有需要的依赖
    List<File> downloadedJars = DependencyDownloader.fetchDependencies();
    
    // 2. 把JAR注入Spring Boot类加载器
    addJarsToSpringClassLoader(downloadedJars);
    
    // 3. 启动Spring Boot应用
    SpringApplication.run(YourApplication.class, args);
}

注意：不要在@Component或@Configuration类中执行依赖下载，这些类会被Spring提前扫描加载，此时依赖还未准备好。

3. 修正Pom.xml配置 #

确保动态依赖在编译时不打包，同时保留依赖坐标供Aether下载：

<dependencies>
    <!-- JDA依赖：编译时不打包，运行时通过Aether下载 -->
    <dependency>
        <groupId>net.dv8tion</groupId>
        <artifactId>JDA</artifactId>
        <version>5.0.0-beta.20</version>
        <scope>provided</scope>
    </dependency>
    
    <!-- Aether相关依赖：必须打包进最终JAR，作为下载工具 -->
    <dependency>
        <groupId>org.apache.maven</groupId>
        <artifactId>maven-aether-provider</artifactId>
        <version>3.8.6</version>
    </dependency>
    <dependency>
        <groupId>org.eclipse.aether</groupId>
        <artifactId>aether-impl</artifactId>
        <version>1.9.0</version>
    </dependency>
    <dependency>
        <groupId>org.eclipse.aether</groupId>
        <artifactId>aether-transport-http</artifactId>
        <version>1.9.0</version>
    </dependency>
</dependencies>

4. 验证类加载状态 #

如果仍报错，添加JVM参数打印类加载日志，确认类是否被Spring的类加载器加载：

-verbose:class

日志中如果看到JDA类由LaunchedURLClassLoader加载，说明配置生效。

常见坑点 #

• 不要在Spring自动配置类中引用动态加载的类，自动配置会在上下文初始化早期执行，此时依赖可能未加载。
• 如果动态依赖包含Spring自动配置类，需手动通过@Import或SpringApplicationBuilder.sources()触发加载。

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