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

引言

在开发过程中你的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文件，确保项目依赖清晰、稳定。

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