maven排查jar包版本冲突

最新推荐文章于 2025-07-14 22:38:52 发布
原创 最新推荐文章于 2025-07-14 22:38:52 发布 · 8.6k 阅读 · 6 ·
CC 4.0 BY-SA版权
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
文章标签：

#maven #jar包冲突

本文介绍如何使用Maven命令解决项目中的依赖冲突问题，包括如何查找冲突的依赖、排除不必要的依赖版本等步骤。

摘要生成于 C知道 ，由 DeepSeek-R1 满血版支持， 前往体验 >

场景描述

有时候在pom中引入了新的jar包，由于maven会根据传递依赖，将该jar包依赖的其他jar包自动下载。因此，自动下载的jar包和已存在的jar包可能存在相同的jar包，但是版本不一致。此处就造成了冲突

排查方法

1、在命令行中，跳转到项目路径。
2、先清除，再重新安装：mvn clean install. 如果不想运行单元测试类，则运行命令:mvn -Dmaven.test.skip=true clean install
3、查询依赖关系，并导入到名为tree.txt的文件中：mvn dependency:tree -Dverbose > tree.txt
4、在tree.txt文件中搜索：conflict。如果存在，则有冲突jar包，需确定jar包版本，把不需要的jar包版本排除。

下图为tree.txt中存在冲突的jar包样例

文件实例

Maven学习总结（59）—— Jar 包依赖冲突最全解决方案
科技D人生
07-11 1597
在实际开发中，多模块项目常会使用 Maven 进行包管理。在 poml 文件中进行包依赖时，常存在引入一个 jar 包中默认依赖了其他的 jar 包的情况。这样很容易导致 jar 包冲突，从而产生一些诡异问题，如版本问题导致的类、方法找不到等。下面我们将聊聊具体关于依赖冲突产生的原因、排查方式以及解决的方案。当存在 groupId 和 artifactId 一致但是 version 不一致的 jar 包冲突时，模块会自动选择距离自己路径短的包。如：bepe-manager 到 common-lib (1.0
Spring Boot 项目中 Maven 剔除无用 Jar 引用的最佳实践
fudaihb的博客
12-25 2139
在 Spring Boot 项目开发中，Maven 是最常用的构建工具之一。通过 Maven，我们可以轻松地管理项目所需的依赖。然而，随着项目的复杂化，无用的 Jar 包引用可能会逐渐增多，导致构建时间延长、运行效率下降，甚至引发潜在的依赖冲突问题。 本文旨在详细解析如何在 Spring Boot 项目中剔除无用的 Jar 引用，并提供一套系统化的清理和优化方法，帮助开发者构建高效、清晰、轻量化的项目依赖管理体系。
Idea Maven Jar版本冲突的排查与解决
09-30 2889
一个庞大的JAVA工程里，往往会依赖引入同一个Jar包的多个版本，如果处理不当，则会导致项目启动失败或者运行过程中出现意想不到的问题。一个工程里Jar包版本的统一，不仅便于后续的运维维护，也有利于版本的统一升级管理，这也体现了一个工程师的技术水平和技术素养。那么，如果原来的项目里存在同一个Jar包多版本冲突的问题怎么排查解决呢？下面我就来分享一下我是怎么排查解决的吧！
maven 查看jar包冲突方法
qq_33529102的博客
08-09 2996
mvn dependency:tree -Dverbose > tree.txt 导出tree.txt，搜索confilct 下文转载至 https://blog.youkuaiyun.com/sinat_39789638/article/details/78005945 1、第一声明优先原则： 在pom.xml配置文件中，如果有两个名称相同版本不同的依赖声明，那么先写的会生效。 所以，先声明自己...
JAR 包冲突排雷指南：原理、现象与 Maven 一站式解决
最新发布
小青年的博客
07-14 268
一次诡异的，90 % 都是由同一个类在多个版本间反复横跳引起的。
maven排查冲突jar包
不见其长，日有所长
02-27 1487
1. 问题描述 使用maven可以非常方便的管理我们项目的各种依赖，但是也存在着一些问题。当我们在pom.xml文件中引入新的jar包，那么该jar包依赖的其它jar包也会自动被下载。如果这些自动下载的jar包和项目中已存在的jar包版本不一致，那么就会造成jar包版本的冲突。 2. 解决方法 我们可以使用mvn命令来排查项目中存在版本冲突的jar包。 首先，在命令行跳转到当前项目路径（如果...
【java】maven处理jar包冲突
wangdong的博客
09-19 657
jar包冲突排查处理
Maven查看和解决jar包冲突
m0_46449152的博客
02-16 269
java
Maven中关于jar包冲突的2种排查方案及3种解决方式
热门推荐
一切有为法，如梦亦如幻，如露亦如电，应作如是观。
07-10 1万+
在实际开发中，多模块项目常会使用Maven进行包管理。在poml文件中进行包依赖时，常存在引入一个jar包中默认依赖了其他的jar包的情况。这样很容易导致jar包冲突，从而产生一些诡异问题，如版本问题导致的类、方法找不到等。 下面我们将聊聊具体关于依赖冲突产生的原因、排查方式以及解决的方案。 1.什么是依赖传递 举个简单例子，比如一个多模块项目依赖关系如下图。其中bepe-dal引入了common-lib，当bepe-manager模块中引入bepe-dal时，common-lib这个依赖也会被引
jar包问题排查脚本.zip
02-22
在Java开发中，有效地管理和排查jar包问题不仅能提升项目的稳定性和性能，还能减少调试时间，提高开发效率。 总结起来，`find-jar-field`、`grep-jar`和`jar-conflict-detect`这三个脚本是Java开发者必备的工具，...
【Maven】Maven 基础教程（五）： jar 包冲突问题
Code · Cloud · Think · Repeat
03-07 1694
编订依赖列表的程序员，初次设定一组依赖，因为尚未经过验证，所以确实有可能存在各种问题，需要做有针对性的调整。那么谁来做这件事呢？我们最不希望看到的就是：团队中每个程序员都需要自己去找依赖，即使是做同一个项目，每个模块也各加各的依赖，没有统一管理。那前人踩过的坑，后人还要再踩一遍。而且大家用的依赖有很多细节都不一样，版本更是五花八门，这就让事情变得更加复杂。
IDEA查看Maven项目中jar包冲突
web15286201346的博客
04-19 4230
在Maven项目中pom.xml中的jar包下载的过程中，依赖可能会出现jar依赖冲突的问题,IDEA为我们提供了maven视图 在IDEA工具中查看jar冲突 进入到Maven项目的pom.xml文件中使用IDEA中的快捷键:ctrl+alt+shift+u，就可以出现以下的页面中: 这个页面我们就可以看的很清楚，项目中所有依赖的jar包，我们也看到了有一个jar包中的依赖发生了冲突，我们shift+delete 删除这个依赖的jar包，或者点击进入这个jar，进行注释，这个不可取 还有一种方法也
Maven Idea查看解决jar包冲突
time_art的博客
05-24 7364
1.选择Maven Project 2.选中Dependencies 3.点击Show Dependencies 在项目依赖图中，有一些红色标记的线，实际上，这些红色标记出来的线所指向的 jar 包，就是项目中冲突的 jar 包！且在我们点击 jar 包之后，还会显示出多条指向 jar 包的红色虚线，其代表着该 jar 包被多次引用，及具体引用路径。 想要排除冲突的 jar 包，其方法为：点击冲突的 jar 包，右键呼出菜单栏，点击Exclude选项。 ...
Maven里同一个jar包有多个版本
06-18 6510
External Libraries里同一个jar包有多个版本 如图所示之前pom文件edu-common引过1.8.5和1.9.6，这次我在pom文件中edu-common引的是1.0.0-SNAPSHOT版本但External Libraries中遗留了之前的版本，并且类中引用的还是之前的本版，从而导致某些引用找不到。 解决方法：从自己的maven本地仓库删除历史版本文件，删除.idea中的libraries文件，然后重启即可解决 ...
idea maven search for class_Maven是什么？为什么使用
weixin_39603357的博客
11-24 344
Welcome to Apache Maven​maven.apache.orgWhy使用Maven：一个项目就是一个工程如果项目非常庞大，就不适合使用package来划分模块，最好是每一个模块对应一个工程，利于分工协作。借助于maven就可以将一个项目拆分成多个工程项目中使用jar包，需要“复制”、“粘贴”项目的lib中同样的jar包重复的出现在不同的项目工程中，你需要做不停的复制粘贴的重复工作...
Maven jar 的查找及依赖版本确定
牧码人的专栏
02-26 3684
maven 依赖的 jar 查找，版本确认，依赖兼容性
每日一面 - 下面这个 maven 依赖，我们有两个一样的依赖，但是不同的版本，最后项目会依赖哪个版本呢？
web17886480312的博客
04-29 397
下面这个 maven 依赖，我们有两个一样的依赖，但是不同的版本，最后项目会依赖哪个版本呢 答案是 28.2-jre，相同依赖不同版本，以最后的为准，依赖会被替换。 验证：
windows窗口排查jar包冲突
04-21
### 排查和解决 Windows 系统中的 Java JAR 包冲突问题 在 Windows 系统中排查和解决 Java JAR 包冲突问题，可以遵循以下方法和技术手段来有效识别并解决问题。 #### 1. **理解 Jar 包冲突的原因** Jar 包冲突通常发生在多个不同版本的库被加载到同一个运行环境中时。这种冲突可能导致某些类或方法无法正常工作，甚至抛出 `ClassNotFoundException` 或 `NoSuchMethodError` 的错误[^1]。主要原因包括： - 不同模块之间依赖了同一库的不同版本。 - 自动引入的传递性依赖与手动指定的依赖版本不一致。 #### 2. **使用 Maven 工具分析依赖树** Maven 是一种常用的构建工具，在其帮助下可以通过命令行查看项目的依赖关系及其潜在冲突情况。执行以下命令可以帮助发现冲突： ```bash mvn dependency:tree ``` 该命令会打印当前项目的所有依赖项，并标注哪些依赖可能发生了冲突。通过观察输出结果，能够快速找到重复或者相互矛盾的依赖条目[^2]。 #### 3. **调整依赖范围排除多余组件** 一旦确认了具体的冲突源之后，就可以采取措施去修正它。常用的方法有： - 使用 `<exclusions>` 节点显式移除不需要的子依赖； - 明确声明所需的最低稳定版号以覆盖其他自动解析出来的较旧版本。 例如，在 POM 文件里添加如下配置可防止某个特定 artifact 被间接拉取进来： ```xml <dependency> <groupId>example.group</groupId> <artifactId>conflicting-library</artifactId> <version>desired-version</version> <exclusions> <exclusion> <groupId>*</groupId> <artifactId>*</artifactId> </exclusion> </exclusions> </dependency> ``` #### 4. **利用 IDE 功能辅助诊断** 现代集成开发环境 (IDE)，像 IntelliJ IDEA 和 Eclipse 都内置支持可视化展示项目结构及关联资源的功能。这些特性使得开发者更容易察觉那些隐藏起来却影响程序行为的因素。比如，在 IntelliJ 中打开 “Project Structure -> Modules -> Dependencies”，即可直观看到各个 module 所引用的 libraries 列表[^3]。 #### 5. **验证 ClassLoader 加载机制** 由于 JVM 在处理相同全限定名(class name)的对象实例化请求时只会采纳最先遇到的那个定义体，因此即使表面上看两个独立的 .jar 文档各自包含了各自的实现细节，实际上后者会被前者屏蔽掉而不生效[^4]。为了确保预期效果得以体现，有必要重新审视整个应用程序启动流程里的 classpath 设置部分，必要时候手工干预排列顺序使之满足业务逻辑需求。 --- ### 总结 综上所述，针对 windows 平台上的 java 应用遭遇 jar package collision issue ，我们推荐从以下几个方面入手加以应对：借助 mvn plugin 查阅完整的 dependency hierarchy；合理运用 xml tags 来定制化的控制最终 assembly composition；善用主流 ide 提供的相关 service 达成更高效的 trouble-shooting purpose 。同时也要注意了解底层 runtime environment 对于 resource selection rule 的规定以便做出更为精准的判断决策。
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值