Java Maven 中怎么通过合理配置依赖排除解决 Jar 包版本冲突

雨雪酱_1775

雨雪酱_1775

2026-07-29

456人浏览

原创

最常用且最精准的解决方式是直接在pom.xml中用切断不需要的传递依赖;需先用mvn dependency:tree -dverbose或-dincludes定位冲突源头,在引入该依赖的块内精准排除,仅写groupid和artifactid,排除后须验证版本唯一性及功能完整性,并建议配合dependencymanagement统一版本。

java maven 中怎么通过合理配置依赖排除解决 jar 包版本冲突

直接在 pom.xml 中用 <exclusions></exclusions> 切断不需要的传递依赖,是最常用也最精准的解决方式。关键不是“排除越多越好”,而是“排除得准、排得稳”。

明确谁引入了冲突版本

先运行命令定位源头:

  • mvn dependency:tree -Dverbose:显示所有被裁剪(omitted for conflict)和被忽略的节点,不漏隐藏路径
  • mvn dependency:tree -Dincludes=groupId:artifactId:聚焦查看某个包(如 org.apache.logging.log4j:log4j-core)被哪些依赖层层带入

例如输出中看到:
[INFO] | \- org.springframework.boot:spring-boot-starter-logging:jar:2.7.18:compile
[INFO] | \- org.apache.logging.log4j:log4j-core:jar:2.17.2:compile
[INFO] \- com.example:legacy-sdk:jar:1.2.0:compile
[INFO] \- org.apache.logging.log4j:log4j-core:jar:2.11.2:compile (omitted for conflict)
说明 legacy-sdk 带来了旧版 log4j-core,而 Spring Boot 引入了新版——冲突就在这里,排除目标应是 legacy-sdk 的传递依赖。

在对应依赖块内写 exclusion

不是全局删包,而是“在哪引入的,就在哪排除”:

  • 只写 <groupid></groupid> 和 <artifactid></artifactid>,不用写 <version></version>
  • exclusion 只作用于当前 <dependency></dependency> 的传递链,不影响其他依赖
  • 如果一个依赖多次出现(比如多个模块都用了 fastjson),需在每个声明处分别排除

示例:

Java Maven Code Review
Java Maven Code Review

审查Java Maven项目(ZIP压缩包或GitLab仓库URL),检查代码规范、命名、模块边界、可维护性问题以及重复代码。

下载
<dependency><groupid>com.example</groupid><artifactid>legacy-sdk</artifactid><version>1.2.0</version><exclusions><exclusion><groupid>org.apache.logging.log4j</groupid><artifactid>log4j-core</artifactid></exclusion><exclusion><groupid>org.apache.logging.log4j</groupid><artifactid>log4j-api</artifactid></exclusion></exclusions></dependency>

排除后必须验证效果

排除不是一劳永逸,要确认它真正生效:

  • 再次执行 mvn dependency:tree -Dincludes=org.apache.logging.log4j:log4j-core
  • 检查输出里是否只剩一个版本(且是你期望的版本),且不再出现 omitted for conflict
  • 启动应用,重点测试原本报错的功能点(如日志输出、JSON 序列化等),避免因排除导致功能缺失

注意:若排除后某功能异常(比如 legacy-sdk 内部硬编码调用了 log4j 2.11 特有 API),说明不能简单排除,需升级 SDK 或改用适配层。

配合 dependencyManagement 更稳妥

单纯 exclusion 容易遗漏或维护困难,建议搭配 <dependencymanagement></dependencymanagement>:

  • 在父 POM 或当前 POM 的 <dependencymanagement></dependencymanagement> 中声明统一版本(如 log4j-core 2.20.0)
  • 这样即使某个依赖没被排除,Maven 也会按管理版本拉取,降低冲突概率
  • exclusion + version lock 双保险,既切断干扰路径,又兜底保障版本一致性

Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

java maven

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
java
java

Java是一个通用术语,用于表示Java软件及其组件,包括“Java运行时环境 (JRE)”、“Java虚拟机 (JVM)”以及“插件”。php中文网还为大家带了Java相关下载资源、相关课程以及相关文章等内容,供大家免费下载使用。

2023.06.15

10077

6

java正则表达式语法
java正则表达式语法

java正则表达式语法是一种模式匹配工具,它非常有用,可以在处理文本和字符串时快速地查找、替换、验证和提取特定的模式和数据。本专题提供java正则表达式语法的相关文章、下载和专题,供大家免费下载体验。

2023.07.05

7222

9

java自学难吗
java自学难吗

Java自学并不难。Java语言相对于其他一些编程语言而言,有着较为简洁和易读的语法,本专题为大家提供java自学难吗相关的文章,大家可以免费体验。

2023.07.31

6352

8

java配置jdk环境变量
java配置jdk环境变量

Java是一种广泛使用的高级编程语言,用于开发各种类型的应用程序。为了能够在计算机上正确运行和编译Java代码,需要正确配置Java Development Kit(JDK)环境变量。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.08.01

1104

3

java保留两位小数
java保留两位小数

Java是一种广泛应用于编程领域的高级编程语言。在Java中,保留两位小数是指在进行数值计算或输出时,限制小数部分只有两位有效数字,并将多余的位数进行四舍五入或截取。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.08.02

908

3

java基本数据类型
java基本数据类型

java基本数据类型有:1、byte;2、short;3、int;4、long;5、float;6、double;7、char;8、boolean。本专题为大家提供java基本数据类型的相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.02

1336

5

java有什么用
java有什么用

java可以开发应用程序、移动应用、Web应用、企业级应用、嵌入式系统等方面。本专题为大家提供java有什么用的相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.02

2649

5

java在线网站
java在线网站

Java在线网站是指提供Java编程学习、实践和交流平台的网络服务。近年来,随着Java语言在软件开发领域的广泛应用,越来越多的人对Java编程感兴趣,并希望能够通过在线网站来学习和提高自己的Java编程技能。php中文网给大家带来了相关的视频、教程以及文章,欢迎大家前来学习阅读和下载。

2023.08.03

19971

3

配置java环境变量
配置java环境变量

配置Java环境变量是为了让操作系统能够识别和使用Java的相关命令和功能。本专题为大家提供配置java环境变量相关文章,帮助大家解决问题。

2023.08.03

1175

8

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
dev.java 官方:Learn Java
dev.java 官方:Learn Java

共0课时 | 0人学习

Java JDBC数据库连接官方教程
Java JDBC数据库连接官方教程

共0课时 | 0人学习