快捷導(dǎo)航

Maven依賴沖突問題及解決過程

更新時間：2026年04月29日 10:06:44 作者：秦JaccLink

文章主要討論Maven依賴沖突問題,及提供解決方法,首先描述了依賴沖突現(xiàn)象的nd導(dǎo)致類NoClassDefFoundError的情況；然后介紹了查找沖突包的方法,最后總結(jié)了Maven依賴管理的幾種策略,包括依賴調(diào)解、依賴排除和依賴范圍控制；強調(diào)了合理配置POM文件的重要性

引言

在開發(fā)過程中你的maven依賴有沖突，但是打包的Jar包照樣可以運行只有使用到?jīng)_突包里的功能時會報依賴沖突錯誤比如：

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>