Gradle依赖冲突解析时选择旧版本问题咨询

核心误解纠正 #

Gradle默认的依赖解析策略并非简单选择最新版本，而是遵循「最短路径优先」原则——只有当多个版本的依赖路径长度相同时，才会选择版本号最高的那个。这是你遇到问题的关键原因。

你的场景分析 #

从依赖树输出org.liquibase:liquibase-core:4.16.1 -> 4.5.0可以看出，4.5.0的依赖路径长度比4.16.1更短，因此被Gradle优先选中。比如：

• 可能某个顶层依赖直接声明了4.5.0（路径长度为1），而4.16.1是通过多层传递依赖引入的（路径长度大于1）；
• 或者两者路径长度相同，但Gradle 6.x的解析逻辑中存在其他优先级规则（比如依赖声明顺序）导致旧版本被选中。

Gradle 6.9.2依赖解析规则（官方文档核心内容） #

• 最短路径优先：依赖路径层级越少，优先级越高。例如直接在项目中声明的依赖（路径长度1），优先级高于任何传递依赖（路径长度≥2）。
• 同路径长度选最高版本：当多个版本的依赖路径长度一致时，Gradle才会选择版本号最高的那个。
• 可配置的解析策略：你可以通过resolutionStrategy自定义冲突处理逻辑，覆盖默认规则。

你可能遗漏的点 #

1. 忽略了「最短路径优先」的优先级高于版本号，错误认为Gradle会无条件选择最新版本；
2. 未排查4.5.0的具体来源——它可能是某个核心依赖直接引入的，路径层级更短；
3. 未使用dependencyInsight命令做精准排查，无法明确版本优先级的具体原因。

解决方法 #

1. 强制指定版本：通过resolutionStrategy锁定目标版本，覆盖默认解析逻辑：

   configurations.all {
       resolutionStrategy.force 'org.liquibase:liquibase-core:4.16.1'
   }
   

2. 声明直接依赖：直接在dependencies块中添加该依赖，利用「最短路径」优先级强制使用指定版本：

   dependencies {
       implementation 'org.liquibase:liquibase-core:4.16.1'
   }
   

3. 精准排查依赖来源：执行以下命令查看每个版本的依赖路径和优先级原因：

   ./gradlew dependencyInsight --dependency org.liquibase:liquibase-core
   

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