Maven 处理依赖冲突

Maven处理依赖冲突

什么是依赖冲突?

当项目中直接或者间接的引入多个版本的同一依赖时则会出现依赖冲突

如何解决?

Maven自动处理依赖冲突的规则

路径优先原则

当依赖冲突发生时,Maven 会优先选择路径最短的依赖版本。路径长度是指从当前项目到依赖的层级深度。例如:项目直接引入的a:v1,及b:v1,但b:v1中引入了a:v2。那么项目自动会引入a:v1。因为a:v1 比 b:v1->a:v2 路径更短
实例:package-b 引入了 logback.1.5.14,及package-a 但是,package->a 引入了 logback.1.5.13。直接maven 选择了logback.1.5.14 符合路径优先原则

第一声明优先原则

如果两个依赖的路径长度相同,Maven 会优先选择在 pom.xml 文件中先声明的依赖版本。例如:项目直接引入了a:v1->b:v1,与a:v2->b:v2 但是a:v1是在a:v2前先声明的,那么就会选择a:v2中的b:v1 反之选择b:v2

注意

坑!!!!

直接在pom.xml中引入两个相同坐标但不同版本的依赖时,不会按照声明优先原则选择。而是使用最后声明的依赖。

[WARNING] 'dependencies.dependency.(groupId:artifactId:type:classifier)' must be unique: ch.qos.logback:logback-core:jar -> version 1.5.14 vs 1.5.13 @ line 23, column 21->表示同一个pom下不能声明相同的坐标。这就导致maven直接选择了最后声明的依赖

子模块覆盖父模块

子模块可以通过在自己的 pom.xml 文件中直接声明依赖的版本来覆盖父模块的版本。Maven 的依赖解析规则会优先考虑子模块中直接声明的依赖版本。

父模块声明dependency子模块覆盖dependency
父模块声明dependencyManagement 子模块覆盖dependency
父模块声明dependencyManagement 子模块覆盖dependencyManagement

Maven手动处理依赖冲突

Maven自动处理依赖后导致引入了低版本的依赖

package-g:1.0,package-g:2.0。通常我们是使用高版本的包,但是因为路径优先原则,导致使用了低版本的依赖。这种就需要手动解决了。

解决方案

思路:通常我们高版本的依赖兼容低版本的依赖。那么我只需要依赖高版本的依赖即可。

exclusions

使用于不能修改package-h内部的场景

xml 复制代码
<dependencies>
      <dependency>
          <groupId>com.mfyuan</groupId>
          <artifactId>package-j</artifactId>
          <version>1.0-SNAPSHOT</version>
      </dependency>
      <dependency>
          <groupId>com.mfyuan</groupId>
          <artifactId>package-h</artifactId>
          <version>1.0-SNAPSHOT</version>
          <exclusions>
              <exclusion>
                  <groupId>com.mfyuan</groupId>
                  <artifactId>package-g</artifactId>
              </exclusion>
          </exclusions>
      </dependency>
  </dependencies>

将低版本的依赖通过exclusion给排除掉即可。这样就没有发生依赖冲突了。

optional

optional为true时,不将该依赖传递给外层。这样就可以避免造成依赖冲突的问题。

适用场景:可以修改package-h内部的pom.xml一般都为自己开发的jar包

xml 复制代码
<dependencies>
    <dependency>
        <groupId>com.mfyuan</groupId>
        <artifactId>pacage-g</artifactId>
        <version>1.0-SNAPSHOT</version>
        <!--不将该依赖传递给外层-->
        <optional>true</optional>
    </dependency>
</dependencies>
注意

高版本如果没有兼容低版本怎么办?这种情况会造成编译失败,或者ClassNotFoundException。如果你又需要高版本的功能也需要低版本的功能那么这种问题是解决不了的。

工具

idea插件:Maven Helper

可以快速查看那些依赖存在冲突

相关推荐
果果软件17 分钟前
2026 后台管理系统选型:若依、JeecgBoot、芋道、NocoBase 和 GewuMind Boot 怎么选?
java·人工智能·后端·ai·开源
Wellijohn1 小时前
我把公司内部的 12 个 CRUD 接口交给了 AI Agent,然后省出了两周
人工智能·python·mcp
2601_967980113 小时前
python pytest怎样测试代码
python·pytest·测试·文档·断言
伞伞悦读3 小时前
【第92期】逻辑回归的分数概率与阈值的实验与排查
人工智能·python·深度学习·机器学习
码云社区3 小时前
Java家政服务系统源码:人员技能、服务范围与多商家业务落地
java·开发语言·家政服务·家政小程序·家政系统
ch6234 小时前
🚀 从零构建本地文档智能审查 Agent:Vibe Coding 实战指南
python
摇滚侠4 小时前
《On Java 中文版 基础卷》阅读笔记 接口 18
java·笔记·python
CoderYanger5 小时前
Java EE 进阶:9.MyBatis 操作数据库(进阶)(第八弹):MyBatis Generator
java·数据库·spring boot·spring·java-ee·tomcat·mybatis
Thanks_ks5 小时前
AI Agent 开发入门:用 Function Calling 让大模型学会 “动手干活”,附订单查询机器人实战
python·ai·大模型·openai·agent·通义千问·mcp
专注仿真5 小时前
智能体训练之模仿学习:GAIL 算法详解与实战
python·算法·仿真·多智能体强化学习·afsim智能体训练