Maven依赖冲突查看以及解决方法

李菠菜2023-12-25 18:26

本文由 简悦 SimpRead 转码， 原文地址 juejin.cn

什么是依赖冲突

依赖冲突是指项目依赖的某一个 jar 包，有多个不同的版本，因而造成类包版本冲突

依赖冲突的原因

依赖冲突很经常是类包之间的间接依赖引起的。每个显式声明的类包都会依赖于一些其它的隐式类包，这些隐式的类包会被 maven 间接引入进来，从而造成类包冲突

如何解决依赖冲突

首先查看产生依赖冲突的类 jar，其次找出我们不想要的依赖类 jar，手工将其排除在外就可以了。具体执行步骤如下

1、查看依赖冲突

a、通过 dependency:tree 是命令来检查版本冲突

复制代码 
mvn -Dverbose dependency:tree

当敲入上述命令时，控制台会出现形如下内容

less 复制代码 
[INFO] org.example:hello:jar:1.0-SNAPSHOT
[INFO] +- org.springframework:spring-context:jar:5.2.7.RELEASE:compile
[INFO] |  +- (org.springframework:spring-aop:jar:5.2.7.RELEASE:compile - omitted for conflict with 5.2.0.RELEASE)
[INFO] |  +- org.springframework:spring-beans:jar:5.2.7.RELEASE:compile
[INFO] |  |  \- (org.springframework:spring-core:jar:5.2.7.RELEASE:compile - omitted for duplicate)
[INFO] |  +- org.springframework:spring-core:jar:5.2.7.RELEASE:compile
[INFO] |  |  \- org.springframework:spring-jcl:jar:5.2.7.RELEASE:compile
[INFO] |  \- org.springframework:spring-expression:jar:5.2.7.RELEASE:compile
[INFO] |     \- (org.springframework:spring-core:jar:5.2.7.RELEASE:compile - omitted for duplicate)
[INFO] \- org.springframework:spring-aop:jar:5.2.0.RELEASE:compile
[INFO]    +- (org.springframework:spring-beans:jar:5.2.0.RELEASE:compile - omitted for conflict with 5.2.7.RELEASE)
[INFO]    \- (org.springframework:spring-core:jar:5.2.0.RELEASE:compile - omitted for conflict with 5.2.7.RELEASE)

其中 omitted for duplicate 表示有 jar 包被重复依赖，最后写着 omitted for conflict with xxx 的，说明和别的 jar 包版本冲突了，而该行的 jar 包不会被引入。比如上面有一行最后写着 omitted for conflict with 5.2.7.RELEASE，表示 spring-core 5.2.0 版本不会被项目引用，而 spring-core 5.2.7 版本会被项目引用

b、如果是 idea，可以安装 maven helper 插件来检查依赖冲突

maven helper 插件安装成功，点开 pom.xml 会发现多了一个 Dependency Analyzer 视图，如下

上面按钮的图标含义如下

  • Conflicts（查看冲突）
  • All Dependencies as List（列表形式查看所有依赖）
  • All Dependencies as Tree（树形式查看所有依赖）

上图说明有 3 个 jar 存在冲突，点击冲突的 jar，可以查看和哪个 jar 产生冲突，如下图

2、解决冲突

项目的 pom.xml 形如下

xml 复制代码 
 <dependencies>
        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-context</artifactId>
            <version>5.2.7.RELEASE</version>
        </dependency>

        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-aop</artifactId>
            <version>5.2.0.RELEASE</version>
        </dependency>


    </dependencies>

通过查看依赖树，我们知道项目会引用 5.2.7.RELEASE 的 spring core jar 包，而不会引用 5.2.0 的 jar 包，如果我们想用 5.2.0 版本的 spring core 包，我们该如何做？

a、使用第一声明者优先原则

谁先定义的就用谁的传递依赖，即在 pom.xml 文件自上而下，先声明的 jar 坐标，就先引用该 jar 的传递依赖。因此我们如果要使用 5.2.0 版本的 spring core 包，我们可以改成如下声明

xml 复制代码 
  <dependencies>
        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-aop</artifactId>
            <version>5.2.0.RELEASE</version>
        </dependency>
        
        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-context</artifactId>
            <version>5.2.7.RELEASE</version>
        </dependency>

    </dependencies>

查看依赖树

less 复制代码 
[INFO] org.example:hello:jar:1.0-SNAPSHOT
[INFO] +- org.springframework:spring-aop:jar:5.2.0.RELEASE:compile
[INFO] |  +- org.springframework:spring-beans:jar:5.2.0.RELEASE:compile
[INFO] |  |  \- (org.springframework:spring-core:jar:5.2.0.RELEASE:compile - omitted for duplicate)
[INFO] |  \- org.springframework:spring-core:jar:5.2.0.RELEASE:compile
[INFO] |     \- org.springframework:spring-jcl:jar:5.2.0.RELEASE:compile
[INFO] \- org.springframework:spring-context:jar:5.2.7.RELEASE:compile
[INFO]    +- (org.springframework:spring-aop:jar:5.2.7.RELEASE:compile - omitted for conflict with 5.2.0.RELEASE)
[INFO]    +- (org.springframework:spring-beans:jar:5.2.7.RELEASE:compile - omitted for conflict with 5.2.0.RELEASE)
[INFO]    +- (org.springframework:spring-core:jar:5.2.7.RELEASE:compile - omitted for conflict with 5.2.0.RELEASE)
[INFO]    \- org.springframework:spring-expression:jar:5.2.7.RELEASE:compile
[INFO]       \- (org.springframework:spring-core:jar:5.2.7.RELEASE:compile - omitted for conflict with 5.2.0.RELEASE)

通过依赖树，我们可以看到项目已经引入 5.2.0 版本的 spring core 包

b、使用路径近者优先原则

即直接依赖级别高于传递依赖。因此我们可以在最先的 pom.xml 添加如下内容

xml 复制代码 
 <dependencies>
        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-context</artifactId>
            <version>5.2.7.RELEASE</version>
        </dependency>

        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-aop</artifactId>
            <version>5.2.0.RELEASE</version>
        </dependency>

        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-core</artifactId>
            <version>5.2.0.RELEASE</version>
        </dependency>



    </dependencies>

通过上图可以看到项目引入是 spring core 5.2.0 的包

c、排除依赖

排除依赖如果是 idea，可以使用 maven helper 插件进行排除。点开 pom.xml，切换到 Dependency Analyzer 视图，选择 All Dependencies as Tree，点击要排除的 jar，右键会出现 Execlude 选项，如下

它产生的效果和如下配置是一样

xml 复制代码 
 <dependencies>
        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-context</artifactId>
            <version>5.2.7.RELEASE</version>
            <exclusions>
                <exclusion>
                    <artifactId>spring-core</artifactId>
                    <groupId>org.springframework</groupId>
                </exclusion>
            </exclusions>
        </dependency>

        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-aop</artifactId>
            <version>5.2.0.RELEASE</version>
        </dependency>

    </dependencies>

通过上图可以看到项目引入是 spring core 5.2.0 的包

4、版本锁定

使用 dependencyManagement 进行版本锁定，dependencyManagement 可以统一管理项目的版本号，确保应用的各个项目的依赖和版本一致。

如果我们项目中只想使用 spring core 5.2.0 的包，pom.xml 可以改为如下

xml 复制代码 
<dependencyManagement>
        <dependencies>
            <dependency>
                <groupId>org.springframework</groupId>
                <artifactId>spring-core</artifactId>
                <version>5.2.0.RELEASE</version>
            </dependency>
        </dependencies>
    </dependencyManagement>

    <dependencies>
        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-context</artifactId>
            <version>5.2.7.RELEASE</version>
        </dependency>

        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-aop</artifactId>
            <version>5.2.0.RELEASE</version>
        </dependency>

    </dependencies>

通过上图可以看到项目引入是 spring core 5.2.0 的包

总结

综上就是 maven 如何排查依赖冲突以及解决方法，对于排查依赖个人比较推荐使用 maven helper 插件，至于解决依赖冲突个人推荐使用版本锁定的方法，此外 dependencyManagement 只是声明依赖，并不自动实现引入，因此子项目需要显示的声明需要用的依赖

相关推荐
间彧6 分钟前
Redis Stream相比阻塞列表和发布订阅有哪些优势？适合什么场景？
后端
间彧11 分钟前
Redis阻塞弹出和发布订阅模式有什么区别？各自适合什么场景？
后端
苏三说技术19 分钟前
统计接口耗时的6种常见方法
后端
SimonKing25 分钟前
Mybatis-Plus的竞争对手来了，试试 MyBatis-Flex
java·后端·程序员
我命由我1234536 分钟前
PDFBox - PDFBox 加载 PDF 异常清单（数据为 null、数据为空、数据异常、文件为 null、文件不存在、文件异常）
java·服务器·后端·java-ee·pdf·intellij-idea·intellij idea
渣哥41 分钟前
当容器里有多个 Bean，@Qualifier 如何精准定位？
javascript·后端·面试
7哥♡ۣۖᝰꫛꫀꪝۣℋ43 分钟前
Spring Boot
java·spring boot·后端
浩泽学编程1 小时前
【源码深度 第1篇】LinkedList：双向链表的设计与实现
java·数据结构·后端·链表·jdk
哲此一生9841 小时前
创建一个SpringBoot项目（连接数据库）
java·spring boot·后端
计算机毕业设计小帅2 小时前
【2026计算机毕业设计】基于Springboot的校园电动车短租平台
spring boot·后端·课程设计
热门推荐
01GitHub 镜像站点02BongoCat - 跨平台键盘猫动画工具03UV安装并设置国内源04GitLab 零基础入门指南：从安装到项目管理全流程05Linux下V2Ray安装配置指南06KGG转MP3工具|非KGM文件|解密音频072025软件测试面试八股文（含答案+文档）08两千字总结：Codex 国内如何安装和使用的教程，以及如何设置中文回答09NVIDIA显卡驱动、CUDA、cuDNN 和 TensorRT 版本匹配指南10荣耀手机2025年10月发布的新品Magic8比起Magic7，在硬件、性能、价格等上有什么区别，有什么优势