高效解决Maven依赖冲突的5种方法(操作步骤)

更新时间：2025年07月09日 09:26:52 作者：代码的余温

本文给大家介绍高效解决Maven依赖冲突的5种方法,结合具体场景说明操作步骤,感兴趣的朋友一起看看吧

⚠️一、基础排除法（<exclusions>标签）

适用场景：排除直接依赖中的传递性冲突包
示例：排除 spring-boot-starter-web 中的 Tomcat 依赖

<dependency>  
    <groupId>org.springframework.boot</groupId>  
    <artifactId>spring-boot-starter-web</artifactId>  
    <exclusions>  
        <exclusion>  
            <groupId>org.springframework.boot</groupId>  
            <artifactId>spring-boot-starter-tomcat</artifactId>  
        </exclusion>  
    </exclusions>  
</dependency>

要点：

无需指定被排除依赖的版本
仅作用于当前声明的依赖项

🧩二、多层级依赖排除

适用场景：冲突由间接依赖（非直接引入）引起
示例：模块 A 依赖模块 B，而 B 传递了冲突库 hsqldb

<dependency>  
    <groupId>com.example</groupId>  
    <artifactId>module-a</artifactId>  
    <exclusions>  
        <!-- 排除模块A传递的hsqldb -->  
        <exclusion>  
            <groupId>org.hsqldb</groupId>  
            <artifactId>hsqldb</artifactId>  
        </exclusion>  
    </exclusions>  
</dependency>

原理：

依赖树：A → B → hsqldb
在 A 的依赖声明中排除 hsqldb 即可切断传递链

🔧三、全局依赖管理（dependencyManagement）

适用场景：统一管理多模块项目的依赖版本
示例：父 POM 强制所有子模块使用安全的 log4j 版本

<!-- 父pom.xml -->  
<dependencyManagement>  
    <dependencies>  
        <dependency>  
            <groupId>org.apache.logging.log4j</groupId>  
            <artifactId>log4j-core</artifactId>  
            <version>2.17.1</version> <!-- 安全版本 -->  
        </dependency>  
    </dependencies>  
</dependencyManagement>

效果：子模块无需声明版本号，自动继承父 POM 的版本

🛡️四、高级排除技巧

1. 空包替换法（彻底排除）

场景：杜绝某依赖被任何途径引入（如高危漏洞库）
操作：

部署空包到私服（如 log4j:log4j:1.0-empty）
在顶层 POM 强制依赖空包：

<dependency>  
    <groupId>log4j</groupId>  
    <artifactId>log4j</artifactId>  
    <version>1.0-empty</version>  
</dependency>

原理：Maven 依赖仲裁优先选择最短路径的空包版本

2. Scope 排除法

场景：排除运行时依赖但保留编译能力

<dependency>  
    <groupId>log4j</groupId>  
    <artifactId>log4j</artifactId>  
    <scope>provided</scope> <!-- 或 test -->  
</dependency>

效果：

provided：编译有效，不打包
test：仅测试有效，不打包

⚙️五、强制检查插件（maven-enforcer-plugin）

场景：防止其他成员意外引入冲突依赖
配置：在父 POM 添加规则

<plugin>  
    <groupId>org.apache.maven.plugins</groupId>  
    <artifactId>maven-enforcer-plugin</artifactId>  
    <executions>  
        <execution>  
            <id>ban-conflict-lib</id>  
            <configuration>  
                <rules>  
                    <bannedDependencies>  
                        <excludes>  
                            <exclude>com.alibaba:fastjson</exclude> <!-- 禁止引入组件 -->  
                        </excludes>  
                        <searchTransitive>true</searchTransitive> <!-- 检查传递依赖 -->  
                    </bannedDependencies>  
                </rules>  
            </configuration>  
        </execution>  
    </executions>  
</plugin>

效果：若有人引入 fastjson，构建直接失败

💡 排除依赖工具对比

方法	适用场景	优势	局限性
`<exclusions>`	简单直接依赖冲突	精准排除单个依赖	需手动定位冲突源
`dependencyManagement`	多模块版本统一	全局版本控制	不适用于非版本冲突场景
空包替换	彻底封杀高危依赖	一劳永逸	需私服权限，维护成本高
Enforcer 插件	团队协作防误引入	强制规范，提前拦截	配置复杂

优先使用基础排除法，对团队协作项目推荐 dependencyManagement + Enforcer 插件组合 。
排查依赖树命令：mvn dependency:tree -Dincludes=groupId:artifactId

到此这篇关于5种高效解决Maven依赖冲突的方法的文章就介绍到这了,更多相关Maven依赖冲突内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！

您可能感兴趣的文章:

Maven
依赖

JavaWeb基础教程之Java基础加强版
这篇文章主要介绍了JavaWeb基础教程之Java基础加强版的相关资料,需要的朋友可以参考下
2016-07-07
maven项目在实践中的构建管理之路的方法
这篇文章主要介绍了maven项目在实践中的构建管理之路的方法，小编觉得挺不错的，现在分享给大家，也给大家做个参考。一起跟随小编过来看看吧
2019-05-05
java 创建线程的方法总结
这篇文章主要介绍了java 创建线程的方法总结的相关资料,需要的朋友可以参考下
2017-03-03
Spring boot整合Mybatis实现级联一对多CRUD操作的完整步骤
这篇文章主要给大家介绍了关于Spring boot整合Mybatis实现级联一对多CRUD操作的相关资料，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面来一起学习学习吧
2019-07-07
Java 中ConcurrentHashMap的实现
本文主要介绍Java 中ConcurrentHashMap的实现，这里整理了详细的资料，及简单实例代码，有兴趣的小伙伴可以参考下
2016-09-09
分析Java中为什么String不可变
Java中为什么String是不可变性的。今天我们从多角度解析为什么Java把String做成不可变的。
2021-06-06
基于JAVA文件中获取路径及WEB应用程序获取路径的方法
下面小编就为大家带来一篇基于JAVA文件中获取路径及WEB应用程序获取路径的方法。小编觉得挺不错的，现在就分享给大家，也给大家做个参考。一起跟随小编过来看看吧
2017-11-11
Java实现表单提交（支持多文件同时上传）
本文介绍了Java、Android实现表单提交（支持多文件同时上传）的方法，具有一定的参考价值，下面跟着小编一起来看下吧
2017-01-01
Draw.io部署详细步骤
Draw.io 是 GitHub 上的一个开源的免费流程图绘制工具,功能非常的丰富,Draw.io 是开源的,所以针对外网访问不稳定或在访问不了外网的情况,我们可以将其部署到我们本地,也就是把本地当作服务端,本文将一步一步介绍具体部署步骤,感兴趣的朋友一起看看吧
2023-10-10
Spring Security登录添加验证码的实现过程
这篇文章主要介绍了Spring Security登录添加验证码的实现过程,文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值,需要的朋友可以参考下
2019-11-11