如何在IDEA中快速解决Jar冲突详解

 更新时间:2021年06月01日 08:54:33   作者:Evan_Leung  
相信很多同学在过去做项目都遇到过Jar冲突的问题,在本地环境没问题,一旦部署到测试或生产环境突然就启动报错,报类似classNotFound的Exception,本文详细整理了如何在IDEA中快速解决Jar冲突,需要的朋友可以参考下

一、为什么会产生Jar包冲突?

作为 Java 开发人员,我们可能会使用 Maven 维护许多应用程序以进行依赖项管理。这些应用程序需要不时升级以保持最新状态并添加新功能或安全更新。

由于某些依赖项之间的冲突,这个简单的任务 - 更新依赖项的版本,很容易变成一场噩梦。解决这些依赖冲突可能需要很多时间。

1.1 直接与传递依赖

Maven 中有两种类型的依赖项:

直接依赖项:

部分中明确包含在我们的项目对象模型 ( pom.xml) 文件中的依赖项<dependencies>。可以使用<dependency>标签添加它们。以下是添加到pom.xml文件中的日志库示例:

<dependencies>
    <dependency>
        <groupId>log4j</groupId>
        <artifactId>log4j</artifactId>
        <version>1.2.17</version>
    </dependency>
</dependencies>

传递依赖项:

我们作为依赖项包含在项目中的项目,如上面的日志库,可以在pom.xml文件中声明自己的依赖项。然后将这些依赖项视为对我们项目的传递性依赖项。当 Maven 拉取一个直接依赖时,它也会拉取它的传递依赖。

1.2 Maven 的传递依赖

现在我们对 Maven 中的不同依赖类型有了一个概述,让我们详细看看 Maven 如何处理项目中的传递依赖。

作为示例,我们将查看 Spring 框架中的两个依赖项:spring-contextspring-security-web.

pom.xml文件中我们将它们添加为直接依赖项,特意选择了两个不同的版本号:

<dependencies>
    <dependency>
        <groupId>org.springframework</groupId>
        <artifactId>spring-context</artifactId>
        <version>5.3.5</version>
    </dependency>
    <dependency>
        <groupId>org.springframework.security</groupId>
        <artifactId>spring-security-web</artifactId>
        <version>5.4.5</version>
    </dependency>
</dependencies>

使用依赖树可视化版本冲突

不了解传递依赖的人会认为使用这个依赖声明只会拉取两个 JAR 文件。幸运的是,Maven 提供了一个命令,它将向我们展示与这两个依赖项相关的确切内容。

我们可以使用以下命令列出所有依赖项,包括可传递的依赖项:

mvn dependency:tree -Dverbose=true

我们使用此命令的详细模式,以便 Maven 告诉我们选择一个版本的依赖项而不是另一个版本的原因。

结果是这样:

+- org.springframework:spring-context:jar:5.3.5:compile
|  +- org.springframework:spring-aop:jar:5.3.5:compile
|  |  +- (org.springframework:spring-beans:jar:5.3.5:compile - omitted for duplicate)
|  |  \- (org.springframework:spring-core:jar:5.3.5:compile - omitted for duplicate)
|  +- org.springframework:spring-beans:jar:5.3.5:compile
|  |  \- (org.springframework:spring-core:jar:5.3.5:compile - omitted for duplicate)
...
   +- (org.springframework:spring-expression:jar:5.2.13.RELEASE:compile - omitted for conflict with 5.3.5)
   \- org.springframework:spring-web:jar:5.2.13.RELEASE:compile
      +- (org.springframework:spring-beans:jar:5.2.13.RELEASE:compile - omitted for conflict with 5.3.5)
      \- (org.springframework:spring-core:jar:5.2.13.RELEASE:compile - omitted for conflict with 5.3.5)

我们从两个依赖开始,在这个输出中,我们发现 Maven 拉取了额外的依赖。这些额外的依赖只是传递性的。

我们可以看到树中有相同依赖项的不同版本。例如,有两个版本的spring-beans依赖项:5.2.13.RELEASE5.3.5.

Maven解决了此版本冲突,但是如何解决?什么是省略了重复和省略的冲突是什么意思?

1.3 Maven 如何解决版本冲突?

首先要知道的是,Maven 无法对版本进行排序:版本是任意字符串,可能不遵循严格的语义序列。例如,如果我们有两个版本1.2和 1.11,我们知道1.11在 之后1.2但字符串比较给出了1.11之前1.2。其他版本值可以是1.1-rc1 或 1.1-FINAL,这就是为什么按 Maven 对版本进行排序不是解决方案的原因。

这意味着 Maven 不知道哪个版本是新的或旧的,并且不能选择总是采用最新的版本。

其次,Maven采用树深度最近的传递依赖并且根据解析顺序中排第一位的版本去解决。为了理解这一点,让我们看一个例子:

我们从一个 POM 文件开始,它有一些具有传递依赖关系的依赖关系(简而言之,所有的依赖关系都用字母 D 表示):

  • D1(v1) -> D11(v11) -> D12(v12) -> DT(v1.3)
  • D2(v2) -> DT(v1.2)
  • D3(v3) -> D31(v31) -> DT(v1.0)
  • D4(v4) -> DT(v1.5)

请注意,每个直接依赖项都会引入不同版本的DT依赖项。

Maven 将创建一个依赖树,并按照上面提到的标准,将选择一个依赖项DT

在这里插入图片描述

我们注意到解析顺序在选择DT依赖项方面发挥了重要作用,因为v1.2v1.5具有相同的深度,但v1.2在解析顺序中排在第一位。所以即使v1.2不是 的最后一个版本DTMaven 也选择了它来使用。

如果我们想v1.5在这种情况下使用 version ,我们可以简单地在我们的 POM 文件中添加D4之前的依赖项D2。在这种情况下,v1.5将首先按照解析顺序,Maven 将选择它。

因此,为了帮助我们理解上面的依赖树结果,Maven 为每个传递依赖指明了为什么它被省略:

  • “省略重复” 意味着 Maven 更喜欢另一个具有相同名称和版本的依赖项而不是这个依赖项(即另一个依赖项根据解析顺序和深度具有更高的优先级)
  • “因冲突而省略” 意味着 Maven 更喜欢另一个具有相同名称但版本不同的依赖项(即根据解析顺序和深度,具有不同版本的另一个依赖项具有更高的优先级)

现在我们很清楚 Maven 是如何解决传递依赖的。出于某种原因,有一天我们可能会选择一个特定版本的依赖项,并摆脱 Maven 为选择它所做的所有过程。为此,我们有两个选择:

1.4 覆盖传递依赖版本

如果我们想自己解决依赖冲突,我们必须告诉 Maven 选择哪个版本。有两种方法可以做到这一点。

1.5 使用直接依赖覆盖传递依赖版本

对于有子模块的项目,为了确保所有模块之间的兼容性和一致性,我们需要一种方法来在所有子模块之间提供相同版本的依赖项。为此,我们可以使用以下dependencyManagement部分:它为 Maven 提供了一个查找表,以帮助确定传递依赖项的选定版本并集中依赖项信息。

一个dependencyManagement 部分包含依赖项元素。每个依赖项都是 Maven 的查找参考,以确定要为传递(和直接)依赖项选择的版本。在本节中,依赖项的版本是强制性的。但是,在该dependencyManagement 部分之外,我们现在可以省略依赖项的版本,Maven 将从中提供的依赖项列表中选择正确版本的传递依赖项dependencyManagement。

需要注意的是,在dependencyManagementsection 中定义一个依赖并不会将其添加到项目的依赖树中,它仅用于查找引用。

理解使用的更好方法dependencyManagement是通过一个例子。让我们回到之前的 Spring 依赖示例。现在我们要玩spring-beans依赖。当我们执行命令时mvn dependency:tree,解析的版本spring-beans是5.3.5.

使用dependencyManagement我们可以覆盖这个版本并选择我们想要的版本。我们所要做的就是将以下内容添加到我们的 POM 文件中:

<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-beans</artifactId>
            <version>5.2.13.RELEASE</version>
        </dependency>
    </dependencies>
</dependencyManagement>

现在我们希望 Maven 解析version 5.2.13.RELEASE而不是5.3.5.

让我们再执行mvn dependency:tree一次命令。结果是:

+- org.springframework:spring-context:jar:5.3.5:compile
|  +- org.springframework:spring-aop:jar:5.3.5:compile
|  +- org.springframework:spring-beans:jar:5.2.13.RELEASE:compile
|  +- org.springframework:spring-core:jar:5.3.5:compile
|  |  \- org.springframework:spring-jcl:jar:5.3.5:compile
|  \- org.springframework:spring-expression:jar:5.3.5:compile
\- org.springframework.security:spring-security-web:jar:5.4.5:compile
   +- org.springframework.security:spring-security-core:jar:5.4.5:compile
   \- org.springframework:spring-web:jar:5.2.13.RELEASE:compile

在依赖关系树,我们找到了5.2.13.RELEASE版本spring-beans。这是我们希望 Maven 为每个spring-beans传递依赖解析的版本。

如果spring-beans是直接依赖,为了利用该dependencyManagement部分,我们将不再需要在添加依赖时设置版本:

<dependency>
    <groupId>org.springframework</groupId>
    <artifactId>spring-beans</artifactId>
</dependency>

这样,Maven 将使用dependencyManagement部分中提供的信息解析版本。

二、通过IDEA快捷解决依赖冲突

2.1 查找冲突

打开pom.xml,点击右键Diagrams->Show Dependencies

2.2 发现冲突

IDEA如果发现Jar冲突,会用红色线高亮现实。在这里,我们可以发现pom.xml中有两个版本的json-path包,分别是2.3.02.3.0

2.3 解决冲突

这时候我们只需要把其中一个包右键选择Exclude,它就会自动帮我们把对应的jar排除掉,这里我选择的是把低版本移除

冲突Jar移除后,新的依赖图已经没有了红线

pom.xml文件自动添加了一个排除项

到此这篇关于如何在IDEA中快速解决Jar冲突详解的文章就介绍到这了,更多相关IDEA解决Jar冲突内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

相关文章

  • idea添加数据库图文教程

    idea添加数据库图文教程

    这篇文章主要介绍了idea添加数据库图文教程,具有很好的参考价值,希望对大家有所帮助。一起跟随小编过来看看吧
    2020-09-09
  • JVM,JRE和JDK的区别小结

    JVM,JRE和JDK的区别小结

    在Java环境配置和项目启动中,JVM,JRE和JDK这三者的配置是项目启动的基础保证,本文就详细的介绍一下这三者的区别,具有一定的参考价值,感兴趣的可以了解一下
    2023-09-09
  • Java线程池之线程复用原理全面解析

    Java线程池之线程复用原理全面解析

    这篇文章主要介绍了Java线程池之线程复用原理,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教
    2024-03-03
  • 从零实现一个简单的Spring Bean容器的代码案例

    从零实现一个简单的Spring Bean容器的代码案例

    Spring是一个非常流行的Java Web开发框架,它提供了强大的依赖注入、面向切面编程、声明式事务管理等功能,为开发者提供了高效、快速地构建Web应用程序的工具,在这篇文章中,咱们将一步一步地构建一个简单的SpringBean容器,需要的朋友可以参考下
    2023-06-06
  • 详解MyBatis直接执行SQL查询及数据批量插入

    详解MyBatis直接执行SQL查询及数据批量插入

    这篇文章主要介绍了MyBatis直接执行SQL查询及数据批量插入的相关知识,需要的朋友一起学习吧
    2016-01-01
  • Java通过反射机制将对象封装成JSON和JsonArray格式

    Java通过反射机制将对象封装成JSON和JsonArray格式

    这篇文章主要介绍了Java通过反射机制将对象封装成JSON和JsonArray格式,JAVA反射机制是在运行状态中,对于任意一个实体类,都能够知道这个类的所有属性和方法,需要的朋友可以参考下
    2023-10-10
  • 详解在Java中如何创建多线程程序

    详解在Java中如何创建多线程程序

    今天给大家带来的是关于Java的相关知识,文章围绕着在Java中如何创建多线程程序展开,文中有非常详细的介绍及代码示例,需要的朋友可以参考下
    2021-06-06
  • MyBatis框架简介

    MyBatis框架简介

    本文主要介绍了MyBatis框架的基础知识。具有很好的参考价值。下面跟着小编一起来看下吧
    2017-03-03
  • mybatis-plus 如何配置逻辑删除

    mybatis-plus 如何配置逻辑删除

    这篇文章主要介绍了mybatis-plus 如何配置逻辑删除,具有很好的参考价值,希望对大家有所帮助。如有错误或未考虑完全的地方,望不吝赐教
    2022-07-07
  • Spring系列中的beanFactory与ApplicationContext

    Spring系列中的beanFactory与ApplicationContext

    这篇文章主要介绍了Spring系列中的beanFactory与ApplicationContext,文章围绕主题展开详细的内容介绍,具有一定的参考价值,需要的小伙伴可以参考一下
    2022-09-09

最新评论