如何通过Gradle将依赖Jar包纳入资源目录？

一、基础实现步骤（本地离线场景） #

1. 准备本地依赖Jar #

把dependency.jar放到项目根目录的libs文件夹下（完全离线可用，无需远程拉取）。

2. 配置Gradle编译依赖 #

在build.gradle（Groovy）或build.gradle.kts（Kotlin）中声明编译时依赖，保证代码正常编译：

// Groovy DSL
dependencies {
    implementation files('libs/dependency.jar')
}

// Kotlin DSL
dependencies {
    implementation(files("libs/dependency.jar"))
}

3. 配置Jar任务，将依赖Jar打包为资源 #

修改Jar任务配置，把dependency.jar复制到最终Jar包的resources/libs目录下：

// Groovy DSL
tasks.named('jar') {
    from('libs') {
        include 'dependency.jar'
        into 'libs' // 最终Jar内的路径：普通Jar为直接/libs，Spring Boot Jar为BOOT-INF/classes/libs
    }
}

// Kotlin DSL
tasks.named<Jar>("jar") {
    from("libs") {
        include("dependency.jar")
        into("libs")
    }
}

4. 运行时加载最新版本的逻辑 #

需自行实现类加载逻辑，确保只加载最新版本的dependency.jar：

• 遍历所有包含该依赖Jar的模块，读取每个Jar内dependency.jar的版本信息（需提前在dependency.jar的Manifest中配置Implementation-Version字段）。
• 筛选出版本最高的dependency.jar，使用URLClassLoader加载：

// 示例加载逻辑（Java）
public class DependencyLoader {
    public static void loadLatestDependency() throws Exception {
        ClassLoader currentClassLoader = DependencyLoader.class.getClassLoader();
        Enumeration<URL> jarUrls = currentClassLoader.getResources("libs/dependency.jar");
        
        URL latestJarUrl = null;
        String latestVersion = "0.0.0";
        
        while (jarUrls.hasMoreElements()) {
            URL url = jarUrls.nextElement();
            JarFile jarFile = new JarFile(new File(url.toURI()));
            Manifest manifest = jarFile.getManifest();
            String version = manifest.getMainAttributes().getValue("Implementation-Version");
            
            // 简化版本比较逻辑，实际可使用专门的版本解析工具类
            if (version != null && version.compareTo(latestVersion) > 0) {
                latestVersion = version;
                latestJarUrl = url;
            }
            jarFile.close();
        }
        
        if (latestJarUrl != null) {
            URLClassLoader classLoader = new URLClassLoader(new URL[]{latestJarUrl}, currentClassLoader);
            Thread.currentThread().setContextClassLoader(classLoader);
        }
    }
}

二、更优方案推荐 #

1. 独立共享依赖Jar，避免重复打包 #

如果允许运行时只部署一份最新版的共享依赖，这是最优解：

• 将dependency.jar单独维护为一个Gradle模块，其他业务项目通过implementation project(':dependency')依赖该模块。
• 发布时仅打包并部署最新版的dependency.jar，所有业务Jar依赖这个公共Jar，彻底避免多版本冲突和重复打包。

2. 使用Java模块化（JPMS） #

将dependency.jar定义为Java模块（在module-info.java中声明模块名），业务Jar在自己的module-info.java中依赖该模块。运行时只需部署最新版的模块Jar，JVM会自动处理依赖解析，避免版本冲突。

3. 阴影插件定向打包（特殊场景） #

如果必须将依赖打包进每个业务Jar，但要避免重复类冲突，可以使用Gradle Shadow插件，仅打包dependency.jar的资源和必要类，同时配置relocate重命名包路径，但这种方式会增加Jar体积，仅适合无法独立部署依赖的场景。

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