idea Maven冲突插件解决技巧

蚂蚁搬家咯
130 阅读2分钟

1. 常见的依赖冲突报错

1.1、版本冲突报错：

[WARNING] Found version conflict(s) in library dependencies; some are suspected to be binary incompatible:
[WARNING] 
[WARNING]   org.apache.commons:commons-lang3:jar:3.4 is referenced from more than one dependency.
[WARNING]     - org.apache.commons:commons-lang3:jar:3.4 (compile)
[WARNING]     - org.apache.commons:commons-lang3:jar:3.5 (compile)

1.2、类找不到或方法找不到：

NoClassDefFoundError 或者 ClassNotFoundException或者 NoSuchMethodException

常见但不仅限于以下异常:
java.lang.NoClassDefFoundError: org/apache/commons/lang3/StringUtils
或者    
java.lang.NoSuchMethodError: org.apache.commons.lang3.StringUtils.isBlank(Ljava/lang/CharSequence;
 
NoSuchMethodException
依赖冲突可能会间接导致 NoSuchMethodException。例如：
    
不同版本的库：如果项目中引入了同一库的不同版本，Maven 可能会选择一个版本，而这个版本中可能缺少某些方法，从而在运行时导致 NoSuchMethodException。
依赖传递：某些依赖可能会引入其他库的特定版本，如果这些版本之间存在不兼容的方法，也可能导致 NoSuchMethodException。

1.3、依赖树中的冲突：

例如：
[INFO] +- org.springframework.boot:spring-boot-starter-web:jar:2.3.4.RELEASE:compile
[INFO] |  +- org.springframework.boot:spring-boot-starter:jar:2.3.4.RELEASE:compile
[INFO] |  |  +- org.springframework.boot:spring-boot:jar:2.3.4.RELEASE:compile
[INFO] |  |  +- org.springframework.boot:spring-boot-autoconfigure:jar:2.3.4.RELEASE:compile
[INFO] |  |  +- org.springframework.boot:spring-boot-starter-logging:jar:2.3.4.RELEASE:compile
[INFO] |  |  |  +- ch.qos.logback:logback-classic:jar:1.2.3:compile
[INFO] |  |  |  |  +- ch.qos.logback:logback-core:jar:1.2.3:compile
[INFO] |  |  |  |  - org.slf4j:slf4j-api:jar:1.7.30:compile
[INFO] |  |  |  +- org.apache.logging.log4j:log4j-to-slf4j:jar:2.13.3:compile
[INFO] |  |  |  |  - org.apache.logging.log4j:log4j-api:jar:2.13.3:compile
[INFO] |  |  |  - org.slf4j:jul-to-slf4j:jar:1.7.30:compile
[INFO] |  |  +- jakarta.annotation:jakarta.annotation-api:jar:1.3.5:compile
[INFO] |  |  +- org.springframework:spring-core:jar:5.2.9.RELEASE:compile
[INFO] |  |  |  - org.springframework:spring-jcl:jar:5.2.9.RELEASE:compile

2、排查maven 依赖是否冲突

2.1、pom 依赖，这里展示部分依赖进行拆解

2.2、使用idea 自带工具进行排查分析：红色的线就表示冲突了。

2.3、使用工具 ：maven helper

首先我使用的idea工具，可以安装插件maven helper，

2.4、重启idea
这玩意装好，我们关闭窗口，有可能会叫你restart一下，你就乖乖听话。之后我们打开pom文件并且点击依赖分析。切换到：Dependency Analyzer

3、分析冲突

3.1、点击右键---》Jump to Source 就会跳回到自己的pom 文件（我这跳转到 56 行）

这个时候我们可以一直向下点击，去看 mybatis 3.5.14 依赖路径和 mybatis 3.5.15 冲突依赖路径版本

4、解决办法

总共有四种解决方式：

1，第一声明优先原则

在pom.xml配置文件中，如果有两个名称相同版本不同的依赖声明，那么先写的会生效（同个pom.xml文件）。

所以，先声明自己要用的版本的jar包即可。

2，路径近者优先

直接依赖优先于传递依赖，如果传递依赖的jar包版本冲突了，那么可以自己声明一个指定版本的依赖jar，即可解决冲突。

3，排除原则

传递依赖冲突时，可以在不需要的jar的传递依赖中声明排除，从而解决冲突。

在pom 文件就会自动生成 排除标识

<dependency>
            <groupId>com.baomidou</groupId>
            <artifactId>mybatis-plus-spring-boot3-starter</artifactId>
            <version>3.5.5</version>
            <!-- 排除掉 冲突的 mybatis（3.5.15） -->
            <exclusions>
                <exclusion>
                    <artifactId>mybatis</artifactId>
                    <groupId>org.mybatis</groupId>
                </exclusion>
            </exclusions>
        </dependency>

结果：

刷新：先返回去pom 点击刷新，然后在 maven help 里面点击 Refresh UI

最后依赖冲突只剩三个

4，版本锁定原则

在配置文件pom.xml中先声明要使用哪个版本的相应jar包，声明后其他版本的jar包一律不依赖。解决了依赖冲突。

<dependencyManagement>
        <dependencies>
            <dependency>
                <groupId>org.mybatis</groupId>
                <artifactId>mybatis</artifactId>
                <version>3.5.14</version>
            </dependency>
        </dependencies>
    </dependencyManagement>

结果：依旧可以排除掉依赖冲突

avatar
文章
阅读
粉丝