Maven依赖冲突

最新推荐文章于 2025-07-06 20:43:56 发布

原创最新推荐文章于 2025-07-06 20:43:56 发布 · 1.5k 阅读

5 ·

CC 4.0 BY-SA版权

文章标签：

#maven #java #spring

Java架构专栏收录该内容

40 篇文章

订阅专栏

依赖冲突

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

依赖传递

项目依赖了A,A依赖了B,项目自动依赖了B

注意：父项目中的依赖有 <scope> 标签属性为 test provided 则不会依赖传递

依赖冲突的原因

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

如何解决依赖冲突

一般maven会自动通过第一声明者优先和就近原则解决冲突

如果不行,首先查看产生依赖冲突的类jar,其次找出我们不想要的依赖类jar,可以手动排除,锁定版本等

一.查看依赖冲突

1.安装Maven Helper插件

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

2.命令行 mvn -Dverbose dependency:tree

二.解决冲突

1.第一声明者优先原则

在pom文件定义依赖,先声明的依赖为准

2.就近原则

A 依赖spring-beans-4.2.4, A 依赖B依赖spring-beans-3.0.5,则spring-beans-4.2.4优先被依赖在A中,因为spring-beans-4.2.4相对spirng-beans-3.0.5被A依赖的路径最近

3.排除依赖

<dependency>
    <groupId>org.apache.struts</groupId>
    <artifactId>struts2-spring-plugin</artifactId>
    <version>2.3.24</version>
    <!-- 排除spring-beans -->
    <exclusions>
        <exclusion>
            <groupId>org.springframework</groupId>
            <artifactId>spring-beans</artifactId>
        </exclusion>
    </exclusions>
</dependency>

4.锁定版本 通过dependencyManagement锁定库的版本

<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-jdbc</artifactId>
            <version>5.2.5.RELEASE</version>
        </dependency>
    </dependencies>
</dependencyManagement>
<dependencies>
    <!--spring的jdbc包  此时导入被锁定的包，不需要写版本号，若写了就以就近原则下载  -->
    <dependency>
        <groupId>org.springframework</groupId>
        <artifactId>spring-jdbc</artifactId>
    </dependency>
</dependencies>

5.提取版本号统一版本号解决

<properties>
    <mybatisplus.version>2.1.3</mybatisplus.version>
</properties>
<dependencies>
    <dependency>
        <groupId>com.baomidou</groupId>
            <artifactId>mybatis-plus</artifactId>
            <version>${mybatisplus.version}</version>
    </dependency>
</dependencies>