如何在Gradle与Maven项目中排查依赖冲突？

Gradle 项目 #

排查冲突方法 #

• 执行命令查看完整依赖树，快速定位冲突来源：

  ./gradlew dependencies
  

  可添加过滤缩小范围，精准查找gson相关依赖：

  ./gradlew dependencies --configuration runtimeClasspath | grep -A 5 -B 5 gson
  

  输出会展示所有引入gson的依赖路径，以及Gradle最终选择的版本和冲突原因。
• 利用IDE工具：IntelliJ IDEA中打开Gradle面板，展开项目的Tasks -> help -> 运行dependencies任务；或通过Project Structure -> Modules -> Dependencies视图，直观查看标记为冲突的依赖版本。

解决冲突（保持构建文件整洁） #

• 借助Spring Boot依赖管理覆盖版本：在build.gradle中通过ext属性指定gson版本，Spring Boot的依赖管理会自动应用该版本，无需重复声明implementation：

  ext['gson.version'] = '2.8.8'
  

• 全局强制版本：若无需依赖管理介入，可通过配置强制所有依赖使用指定版本：

  configurations.all {
      resolutionStrategy.force 'com.google.code.gson:gson:2.8.8'
  }
  

Maven 项目 #

排查冲突方法 #

• 执行命令生成依赖树，过滤gson相关内容：

  mvn dependency:tree -Dincludes=com.google.code.gson:gson
  

  输出会清晰展示所有引入gson的依赖路径，以及Maven依赖仲裁的结果。
• IDE工具：IntelliJ IDEA或Eclipse中打开Maven依赖视图，冲突版本会被标记，可直接查看冲突来源。

解决冲突（保持构建文件整洁） #

• 用dependencyManagement锁定版本：在pom.xml的<dependencyManagement>节点中添加gson的版本定义，Maven会优先使用该版本，无需在<dependencies>中重复引入：

  <dependencyManagement>
      <dependencies>
          <dependency>
              <groupId>com.google.code.gson</groupId>
              <artifactId>gson</artifactId>
              <version>2.8.8</version>
          </dependency>
      </dependencies>
  </dependencyManagement>
  

• 排除特定依赖的gson：若需精准排除Eureka client引入的gson，可在依赖中添加exclusion，但该方式不如dependencyManagement整洁：

  <dependency>
      <groupId>org.springframework.cloud</groupId>
      <artifactId>spring-cloud-starter-netflix-eureka-client</artifactId>
      <exclusions>
          <exclusion>
              <groupId>com.google.code.gson</groupId>
              <artifactId>gson</artifactId>
          </exclusion>
      </exclusions>
  </dependency>
  

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