Maven依赖冲突问题及解决过程

 更新时间:2026年04月29日 10:06:44   作者:秦JaccLink  
文章主要讨论Maven依赖冲突问题,及提供解决方法,首先描述了依赖冲突现象的nd导致类NoClassDefFoundError的情况;然后介绍了查找冲突包的方法,最后总结了Maven依赖管理的几种策略,包括依赖调解、依赖排除和依赖范围控制;强调了合理配置POM文件的重要性

引言

在开发过程中你的maven依赖有冲突,但是打包的Jar包照样可以运行只有使用到冲突包里的功能时会报依赖冲突错误比如:

java.lang.NoClassDefFoundError: org/apache/poi/util/POILogFactory
    at org.apache.poi.hwpf.model.FileInformationBlock.<clinit>(FileInformationBlock.java:52) ~[poi-scratchpad-4.1.2.jar!/:4.1.2]
    at org.apache.poi.hwpf.HWPFDocumentCore.<init>(HWPFDocumentCore.java:170) ~[poi-scratchpad-4.1.2.jar!/:4.1.2]
    at org.apache.poi.hwpf.HWPFDocument.<init>(HWPFDocument.java:193) ~[poi-scratchpad-4.1.2.jar!/:4.1.2]
    at org.apache.poi.hwpf.HWPFDocument.<init>(HWPFDocument.java:177) ~[poi-scratchpad-4.1.2.jar!/:4.1.2]
    at org.apache.poi.hwpf.HWPFDocument.<init>(HWPFDocument.java:165) ~[poi-scratchpad-4.1.2.jar!/:4.1.2]
    at com.zxx.hand.WordHandler.handContent(WordHandler.java:47) ~[classes!/:1.0]
    at com.zxx.hand.DocumentAttachmentHandler.getAttachmentInfo(DocumentAttachmentHandler.java:51) ~[classes!/:1.0]
    at com.zxx.elasticsearch.FileAnalysisElasticsearchTask.fileAnalysis(FileAnalysisElasticsearchTask.java:64) ~[classes!/:1.0]
    at com.zxx.service.impl.FileAnalysisServiceImpl$1.run(FileAnalysisServiceImpl.java:50) ~[classes!/:1.0]
    at java.base/java.util.concurrent.Executors$RunnableAdapter.call(Executors.java:515) ~[na:na]
    at java.base/java.util.concurrent.FutureTask.run(FutureTask.java:264) ~[na:na]
    at java.base/java.util.concurrent.ScheduledThreadPoolExecutor$ScheduledFutureTask.run(ScheduledThreadPoolExecutor.java:304) ~[na:na]
    at java.base/java.util.concurrent.ThreadPoolExecutor.runWorker(ThreadPoolExecutor.java:1128) ~[na:na]
    at java.base/java.util.concurrent.ThreadPoolExecutor$Worker.run(ThreadPoolExecutor.java:628) ~[na:na]
    at java.base/java.lang.Thread.run(Thread.java:834) ~[na:na]
Caused by: java.lang.ClassNotFoundException: org.apache.poi.util.POILogFactory
    at java.base/java.net.URLClassLoader.findClass(URLClassLoader.java:476) ~[na:na]
    at java.base/java.lang.ClassLoader.loadClass(ClassLoader.java:588) ~[na:na]
    at org.springframework.boot.loader.LaunchedURLClassLoader.loadClass(LaunchedURLClassLoader.java:151) ~[nnd-document-parser.jar:1.0]
    at java.base/java.lang.ClassLoader.loadClass(ClassLoader.java:521) ~[na:na]
    ... 15 common frames omitted

1、找出冲突包

1.1 找到pom.xml文件

1.2 点击Show Diagrams查看依赖图

右击pom.xml文件点击--》Show Diagrams

如下图会列出冲突包

2、移除冲突包

maven移除包中依赖

        <dependency>
            <groupId>org.apache.poi</groupId>
            <artifactId>poi-ooxml</artifactId>
            <version>${poi.version}</version>
            <!-- 移除包中依赖 -->
            <exclusions>
                <exclusion>
                    <groupId>org.apache.poi</groupId>
                    <artifactId>poi</artifactId>
                </exclusion>
            </exclusions>
        </dependency>

总结

Maven通过依赖管理解决Jar包冲突,使用依赖调解、依赖排除和依赖范围等策略。

依赖调解选择最近的版本,依赖排除可移除冲突的依赖,依赖范围控制依赖的作用域。

合理配置POM文件,确保项目依赖清晰、稳定。

以上为个人经验,希望能给大家一个参考,也希望大家多多支持脚本之家。

相关文章

  • spring boot在启动项目之后执行的实现方法

    spring boot在启动项目之后执行的实现方法

    在开发时有时候需要在整个应用开始运行时执行一些特定代码,比如初始化环境,下面这篇文章就来给大家介绍了关于spring boot在启动项目之后执行自己要执行的东西的实现方法,文中给出了详细的示例代码,需要的朋友可以参考下。
    2017-09-09
  • Spring Boot2配置服务器访问日志过程解析

    Spring Boot2配置服务器访问日志过程解析

    这篇文章主要介绍了Spring Boot2配置服务器访问日志过程解析,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友可以参考下
    2019-11-11
  • Java的类型擦除式泛型详解

    Java的类型擦除式泛型详解

    Java语言中的泛型只存在于程序源码之中,在编译后的字节码文件里,则全部泛型都会被替换为原来的原始类型(Raw Type),并且会在相应的地方插入强制转型的代码。这篇文章主要介绍了Java的类型擦除式泛型,需要的朋友可以参考下
    2021-08-08
  • Java中Dom4j的配置与使用示例详解

    Java中Dom4j的配置与使用示例详解

    Dom4j是一个强大的Java库,用于处理XML数据,结合了DOM、SAX、JDOM的优点,它可以解析、生成、修改和序列化XML文档,适用于数据交换、配置文件管理、日志记录、数据持久化和Web服务等场景,Dom4j提供了简单易用的API,便于开发者进行高效的XML操作
    2024-10-10
  • Java不定参数使用及一些注意情况

    Java不定参数使用及一些注意情况

    不定参数是一种特殊的参数类型,它允许方法接受可变数量的参数,本文主要介绍了Java不定参数使用及一些注意情况,具有一定的参考价值,感兴趣的可以了解一下
    2024-03-03
  • Java 时间转换的实例代码

    Java 时间转换的实例代码

    下面小编就为大家带来一篇Java 时间转换的实例代码。小编觉得挺不错的,现在就分享给大家,也给大家做个参考。一起跟随小编过来看看吧
    2016-07-07
  • 从入门到精通Spring Boot中WebSocket常用方法

    从入门到精通Spring Boot中WebSocket常用方法

    本文将从入门到精通,详细介绍Spring Boot中WebSocket的常用使用方法,涵盖协议特性、消息收发、点对点通信、认证拦截及注解实现方式,,需要的朋友跟随小编一起看看吧
    2025-08-08
  • Java中mybatis关于example类的使用详解

    Java中mybatis关于example类的使用详解

    这篇文章主要介绍了Java中mybatis中关于example类的使用详解,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2020-07-07
  • 一文带你掌握springBoot如何做到优雅停机的

    一文带你掌握springBoot如何做到优雅停机的

    在分布式系统中,服务的优雅停机(Graceful Shutdown)是确保业务连续性的重要机制,下面就跟随小编一起来深入了解下springBoot实现优雅停机的具体方式吧
    2025-04-04
  • Spring用AspectJ开发AOP(基于Annotation)

    Spring用AspectJ开发AOP(基于Annotation)

    这篇文章主要介绍了Spring用AspectJ开发AOP(基于Annotation),文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友可以参考下
    2019-10-10

最新评论