如何定位、解决maven依赖冲突问题

简介: 如何定位、解决maven依赖冲突问题

1.依赖冲突的原因


如果maven项目中,A依赖于B和C,B依赖于1.0版本的D,C依赖于2.0版本的D,这时候就会出现依赖冲突。


在A上加载使用D依赖的时候,maven会根据依赖路径最短优先原则,加载一个D依赖,另一个是不会被使用的。

在大多数时候,依赖冲突可能并不会对系统造成什么异常,但是,在某些特定的情况下会导致系统报错,比如,版本的变化导致API不同,或者删除了类,而正好又使用到有所变化的API或者被删除的类,那么就会导致系统报错。

2.复现一个依赖冲突场景

为了后文讲解怎么定位依赖冲突,这里我们先复现一个依赖冲突场景。

三个module:

  • orderService
  • productService
  • platformService

依赖关系如下:

orderService依赖:

<dependency>
   <groupId>org.apache.commons</groupId>
   <artifactId>commons-lang3</artifactId>
   <version>3.8.1</version>
</dependency>

productService依赖:

<dependency>
   <groupId>org.apache.commons</groupId>
   <artifactId>commons-lang3</artifactId>
   <version>3.9</version>
</dependency>

platform的依赖:

<dependency>
   <groupId>org.example</groupId>
   <artifactId>orderService</artifactId>
   <version>1.0-SNAPSHOT</version>
</dependency>
<dependency>
     <groupId>org.example</groupId>
     <artifactId>productService</artifactId>
     <version>1.0-SNAPSHOT</version>
</dependency>

3.如何定位依赖冲突

3.1.maven show dependencies

IDEA中自带一个功能,maven show dependencies,右击pom文件可以调出,或者右上角的快捷键也可以调出

maven show dependencies,会为我们显示一棵maven的依赖树:

蓝色箭头是正常的依赖关系,红色箭头是依赖冲突关系。

如果依赖太多,ctrl+F可以弹出依赖列表,在其中可以选择想定位到的依赖:

很遗憾的是maven show dependencies这种方式的场景实在是有限,正常的稍微上一点体量的项目,依赖树都会很大,用这种方式会把人看傻。

这里我随便拿一个博主经历过的项目上的依赖树拿出来,是长这样的:


这种依赖树,根本就没办法去看,就算定位到了,依赖路径的线条你都找不清楚。所以就没有办法了吗?当然是有的,这就是IDEA的一款插件,我们的maven依赖冲突分析利器——maven helper。

3.2.maven helper

首先是下载安装,一定要看准,别装错了,如果IDEA中没办法安装的话直接去官网上下载,然后走本地离线安装即可。

博主,这里已经提前安装好了,第一次安装的话,安装完重启一下IDEA才会生效。

安装完maven helper后,pom.xml文件的左下角会有一个dependency的选项,点击这个选项可以进入maven helper:


all dependencies选项,会展示当前项目的依赖树:

这种目录层级的依赖树,在依赖量大的情况下,比起图形来就要友善很多,其中会用红色标出被冲突掉的依赖,也就是不会被用到的依赖。

conflicts选项,可以根据依赖名来进行依赖的搜索,搜索结果会展示生效的依赖版本,点击会显示项目中该依赖的所有版本,会用红色标出被冲突掉,不生效的版本:

maven helper中右键依赖,可以排除依赖:

它会直接用exclusions来排除依赖:

<dependencies>
    <dependency>
        <groupId>org.example</groupId>
        <artifactId>orderService</artifactId>
        <version>1.0-SNAPSHOT</version>
    </dependency>
 
    <dependency>
        <groupId>org.example</groupId>
        <artifactId>productService</artifactId>
        <version>1.0-SNAPSHOT</version>
        <exclusions>
            <exclusion>
                <artifactId>commons-lang3</artifactId>
                <groupId>org.apache.commons</groupId>
            </exclusion>
        </exclusions>
    </dependency>
</dependencies>

4.依赖路径最短优先原则

这里扩展聊一聊依赖路径最短优先原则。


依赖路径最短优先原则是一种解决依赖冲突的策略,它指定当存在多个冲突的依赖版本时,选择依赖路径最短(即嵌套层级最浅)的版本作为解决方案。这个原则通常被用于 Maven 等构建工具中,以确定在依赖关系中应该使用哪个版本的库。


以下是一个示例,说明依赖路径最短优先原则如何工作:


假设有以下依赖关系:


应用程序 A 依赖于库 B(版本 1.0)和库 C(版本 1.0)。


库 B 依赖于库 C(版本 2.0)。


根据依赖路径最短优先原则,解决冲突的方式是选择最短路径上的依赖版本。在这个例子中,库 B 的依赖路径最短,因此会选择库 C 的版本 1.0 作为解决方案。这样,库 C(版本 2.0)不会被选择,因为它的路径比较长。


这个原则的目的是最小化潜在的依赖冲突问题,因为通常情况下,更短的路径意味着更直接的依赖关系,可能更容易避免冲突。

目录
相关文章
|
8月前
|
Java Maven 微服务
微服务——SpringBoot使用归纳——Spring Boot集成 Swagger2 展现在线接口文档——Swagger2 的 maven 依赖
在项目中使用Swagger2工具时,需导入Maven依赖。尽管官方最高版本为2.8.0,但其展示效果不够理想且稳定性欠佳。实际开发中常用2.2.2版本,因其稳定且界面友好。以下是围绕2.2.2版本的Maven依赖配置,包括`springfox-swagger2`和`springfox-swagger-ui`两个模块。
349 0
|
7月前
|
存储 Java Maven
Maven系统级别依赖:解决部署时Jar包缺失问题
以上就是关于Maven系统级别依赖解决部署时Jar包缺失问题的解答,希望对你有所帮助。在软件开发中,遇到问题并解决问题是常态,希望你能够善用这些工具,解决你遇到的问题。
480 28
|
Java Maven 容器
java依赖冲突解决问题之Maven在编译打包过程中对依赖的jar包如何解决
java依赖冲突解决问题之Maven在编译打包过程中对依赖的jar包如何解决
|
10月前
|
缓存 架构师 Java
Maven实战进阶(01)面试官:Maven怎么解决依赖冲突?| 有几种解决方式
本文介绍了Maven的核心功能和依赖管理技巧。Maven是基于项目对象模型(POM)的构建工具,具备跨平台、标准化、自动化等特性。其三大核心功能为依赖管理、仓库管理和项目构建。依赖管理通过pom.xml文件引入第三方组件并自动下载;仓库管理涉及中央仓库、私服和本地仓库;项目构建则通过生命周期管理编译、测试、打包等流程。文章还详细讲解了依赖冲突的解决方法,包括默认规则、手工排除和版本指定等策略。
|
11月前
|
缓存 Java Maven
【简单四步教你解决♥十分有效】Maven依赖报错、依赖或插件导入失败的万能解决办法
【简单四步教你解决♥十分有效】Maven依赖报错、依赖或插件导入失败的万能解决办法!在处理Maven项目问题时,首先检查Maven配置是否正确。接着通过“File--Invalidata Caches”清除IDEA缓存并重启。使用Maven命令`mvn dependency:purge-local-repository`和`mvn dependency:resolve`清除本地依赖缓存。最后,在Terminal中输入`mvn clean install`完成构建。
3375 1
【简单四步教你解决♥十分有效】Maven依赖报错、依赖或插件导入失败的万能解决办法
|
Java Maven
maven打瘦包,且只打入部分想打入的依赖瘦包
maven打瘦包,且只打入部分想打入的依赖瘦包 设计 工程结构分析 环境管理 城市资源 安全工程 工程管理
259 10
|
XML 安全 Java
【Maven】依赖管理,Maven仓库,Maven核心功能
【Maven】依赖管理,Maven仓库,Maven核心功能
2044 3
|
Java Maven
Maven 依赖管理
Maven 一个核心的特性就是依赖管理。当我们处理多模块的项目(包含成百上千个模块或者子项目),模块间的依赖关系就变得非常复杂,管理也变得很困难。针对此种情形,Maven 提供了一种高度控制的方法。
419 5
|
Java Maven
Maven 引入外部依赖
如果我们需要引入第三方库文件到项目,该怎么操作呢?
262 5

热门文章

最新文章

推荐镜像

更多