如何强制Gradle库使用自身依赖版本而非主项目依赖版本？

Gradle默认依赖解析策略会优先采用主项目直接声明的依赖版本，导致库A被迫使用主项目指定的B-v1。要实现库A单独使用自身依赖的B-v2，可通过以下几种方案处理：

1. 基于Gradle解析策略的版本定向控制 #

针对Gradle 7.0+版本，可通过resolutionStrategy为特定模块指定依赖版本，实现库A与主项目的版本隔离。

Groovy DSL 示例 #

configurations.all {
    resolutionStrategy.eachDependency { DependencyResolveDetails details ->
        // 匹配目标依赖的组名和库名
        if (details.requested.group == '你的B库组名' && details.requested.name == 'library-b') {
            // 当依赖请求来自库A时，强制使用v2版本
            if (details.requested.from?.name == 'library-a') {
                details.useVersion '2.x.x'
            } else {
                // 主项目及其他模块使用v1版本
                details.useVersion '1.x.x'
            }
        }
    }
}

Kotlin DSL 示例 #

configurations.all {
    resolutionStrategy.eachDependency {
        if (requested.group == "你的B库组名" && requested.name == "library-b") {
            if (requested.from?.name == "library-a") {
                useVersion("2.x.x")
            } else {
                useVersion("1.x.x")
            }
        }
    }
}

需替换示例中的组名、库名和版本号为实际项目信息。

2. 对库A进行依赖打包与包重命名（特殊场景适用） #

若库A由你维护，可通过Shadow插件将B-v2打包进库A的Jar包，并重命名B的包路径，从根本上避免版本冲突。

plugins {
    id 'com.github.johnrengelman.shadow' version '7.1.2'
}

shadowJar {
    // 将B库的包路径重命名为库A专属的路径
    relocate 'com.example.libraryb', 'com.example.librarya.shaded.libraryb'
}

此方法会增大包体积，且可能导致重复代码，仅适合无法统一版本的极端场景。

3. 调整库A的依赖声明方式（仅解决传递问题） #

若库A是可控项目，可将其对B的api依赖改为implementation，这样主项目不会继承库A的B-v2依赖，但无法实现库A用B-v2、主项目用B-v1的版本隔离，仅能避免依赖传递冲突。

⚠️ 注意：不同版本依赖共存极易引发NoSuchMethodError、ClassCastException等运行时异常，除非确认库A与B-v2的交互完全独立于主项目逻辑，否则优先考虑统一依赖版本或升级主项目至B-v2版本。

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