[JAVA/Maven/IDEA]解决JAR包冲突
2023-09-27 14:24:41 时间
1 前言
想必这个问题,诸多同仁都遇到过。
很不凑巧,这段时间咱也屡次撞上这问题好几次了。
因此,实在是有必要说说怎么解决好这问题了0.0
2 诊断:包冲突的异常信息特征
- [类定义未发现错误] NoClassDefFoundError
Caused by: java.lang.NoClassDefFoundError: org/springframework/core/env/EnvironmentCapable
- [方法未发现错误] NoSuchMethodError
Exception in thread "Thread-9" java.lang.NoSuchMethodError: org.eclipse.jetty.server.Server.<init>(Lorg/eclipse/jetty/util/thread/ThreadPool;)V
at com.xxl.job.core.rpc.netcom.jetty.server.JettyServer$1.run(JettyServer.java:36)
at java.lang.Thread.run(Thread.java:745)
- [变量未发现错误] NoSuchFieldError
Exception in thread "main" java.lang.NoSuchFieldError
3 包冲突的主要原因
- 情况1:同一JAVA工程,依赖了同一JAR包的两个版本。
这可能导致:出现同名类(但其内的method、property可能不同)、缺少当前工程中所依赖的Java类。
- 情况2:同一JAVA工程,依赖了不同JAR包。
这可能导致:不同JAR包的相同路径中,出现了不同property/method的同名类。何为同名的类?即 类的全限定名相同。
- 情况3:同一Java工程中,源码(非引入的外部JAR包)中存在完全相同包路径的同名类
(包路径+类名均完全相同,但该类少了目标方法或目标方法的实现逻辑不同)
Eg: org.apache.commons-lang3 与 com.google.protobuf
[Example]
2个及以上不同JAR包中均使用了同名的类路径路径org.eclipse.jetty.server.Server.java
而程序真正调用了包冲突导致的错误Server类时,缺少了该方法
4 解决思路与解决过程
4-1 通用方案: 源码工程的pom.xml中排除掉冲突JAR包
针对情况1/2这类一般情况,不适用于情况3这类极端情况
-
step0 Web界面点击某项功能时出现故障。 [start]
-
step1 查看 [服务器日志]
vi /var/ftp/www/myTomcatWebApp/logs/catalina.out
截取有用信息:
- 方法未发现错误[ NoSuchMethodError ] → 大概率是: 包冲突
- 关键类: org.eclipse.jetty.server.Server
Exception in thread "Thread-9" java.lang.NoSuchMethodError: org.eclipse.jetty.server.Server.<init>(Lorg/eclipse/jetty/util/thread/ThreadPool;)V
at com.xxl.job.core.rpc.netcom.jetty.server.JettyServer$1.run(JettyServer.java:36)
at java.lang.Thread.run(Thread.java:745)
- step2 搜索该关键类: org.eclipse.jetty.server.Server
IDEA中打开 Java Web应用的项目源码
Shift + Shift : (搜索) org.eclipse.jetty.server.Server
出现多条结果信息,截取有效的信息:
- org/eclipse/jetty/jetty-server/9.2.22.v20170606/jetty-server-9.2.22.v20170606.jar!/org/eclipse/jetty/server/Server
- org/eclipse/jetty/jetty-server/9.2.22.v20170606/jetty-all-7.6.0.v20120127.jar!/org/eclipse/jetty/server/Server
- step3 确认缺陷 / 确认包冲突
[方法1] 通过step2的信息,可确认包冲突 【推荐】
即 在【jetty-server】和【jetty-all】两个jar包中Server类共用了org.eclipse.jetty.server的JAVA包路径
[方法2] 查看[服务器的Java Web应用的lib库] ,可最终确认 包冲突
[root@zunyi91 ~]# ll /var/ftp/www/myTomcatWebApp/webapps/myWebApp/WEB-INF/lib | grep jetty
-rw-r--r-- 1 root root 540685 4月 3 2019 jetty-6.1.26.cloudera.4.jar
-rw-r--r-- 1 root root 1681148 11月 7 2018 【jetty-all-7.6.0.v20120127.jar】
-rw-r--r-- 1 root root 127310 11月 7 2018 jetty-http-9.2.22.v20170606.jar
-rw-r--r-- 1 root root 108325 11月 7 2018 jetty-io-9.2.22.v20170606.jar
-rw-r--r-- 1 root root 85290 11月 27 2018 jetty-plus-8.1.15.v20140411.jar
-rw-r--r-- 1 root root 89933 11月 27 2018 jetty-security-8.1.15.v20140411.jar
-rw-r--r-- 1 root root 420890 11月 7 2018 【jetty-server-9.2.22.v20170606.jar】
-rw-r--r-- 1 root root 101785 11月 27 2018 jetty-servlet-8.1.15.v20140411.jar
-rw-r--r-- 1 root root 19141 4月 3 2019 jetty-sslengine-6.1.26.cloudera.4.jar
-rw-r--r-- 1 root root 177702 4月 3 2019 jetty-util-6.1.26.cloudera.4.jar
-rw-r--r-- 1 root root 382423 11月 7 2018 jetty-util-9.2.22.v20170606.jar
-rw-r--r-- 1 root root 110102 11月 27 2018 jetty-webapp-8.1.15.v20140411.jar
-rw-r--r-- 1 root root 39077 11月 27 2018 jetty-xml-8.1.15.v20140411.jar
- step4 更新项目源码: POM.xml中排除(exclude)冲突包
+ [安装插件] IDEA在安装解决包冲突的插件(Maven Helper) [Setting>Plugins>(Search)"Maven Helper">Install>重启IDEA]
手动下载IDEA插件的URL:
+ [启动插件] IDEA中打开Java Web项目源码的pom.xml,点击插件的启动按钮"Dependency Analyzer"
+ [分析、查看Maven依赖树] 选择"All Dependencies as Tree",在Conflict中搜索"jetty-server"、"jetty-all",即可出现对应JAR包间的依赖树
+ [exclude] 选择任意JAR包,右键,选择“exclude”,即可 对 目标JAT包进行屏蔽
![](https://img2020.cnblogs.com/blog/1173617/202008/1173617-20200813085817754-1962312671.png)
like this.
- step5 重新打包,重新部署
- step6 验证测试
[验证方法1] 功能测试,看该功能/界面的缺陷是否消失。
[验证方法2] 白盒测试,从代码层诊断是否解决其缺陷。
4-2 反编译包冲突的工程+修改/新增冲突类的目标方法+再编译/打包
4-3 源码工程中新增完全相同包路径的同名类 (以此替换冲突包的类)
适用于情况3这类极端情况
X 推荐文献
相关文章
- 深入解析Java的注解机制
- Java 游戏报错 看不懂求教
- Java之Integer源码
- 《Java开发手册(嵩山版)》最新发布,速速下载!
- 14个Java并发容器,Java高手都知道!
- Java 反射 方法调用
- Java-调用抽象类中指定参数的构造方法
- Java正确比较浮点数的方法
- [Java]变量及其初始化 与 类对象的初始化
- 关于Java中的整数类型值比较的疑问
- java实现微信支付宝等多个支付平台合一的二维码支付(maven+spring springmvc mybatis框架)
- eclipse中使用Maven管理java工程设置jdk版本为jdk1.8
- 【Java】maven多项目资源共享
- 用Maven实现一个protobuf的Java例子
- Maven——DescriptionResourcePathLocationType An error occurred while filtering resourcesssm-crudline 1Maven Java EE Configuration Problem
- Java求geometry的面积最小外接矩形
- Maven项目下 java.lang.ClassNotFoundException 常规解决的方法
- Java并发编程的艺术(六)——线程间的通信
- Java中将JDK中tools.jar配置在maven中
- 学习Java Spring SpringMVC SpringBoot的朋友请看这里~
- Java实现文件夹的监控
- MAVEN创建JAVA的Web工程
- Java JVM、JNI、Native Function Interface、Create New Process Native Function API Analysis
- 大数据必学Java基础(十二):基本数据类型
- maven maven-war-plugin 解决java war项目间的依赖(两个war都可独立部署运行,maven 3.2.x亲测)
- maven单元测试报java.lang.IllegalStateException: Failed to load ApplicationContext
- IDEA创建Maven版Java工程