在java项目工程中,一般会依赖大量的jar包,经常会出现重复依赖的问题,最常见的则是一个jar包同时依赖了多个版本。自从使用了类似与maven这样的项目构建工具之后,多个版本依赖的问题,得到了很好的解决,maven会帮助我们自动去除多余的版本。但还是有一种情况,会出现非常隐蔽的版本冲突的问题,就是一个第三方的jar包里面已经把它自身需要的依赖jar文件,打包成了同一个jar包,然后我们同时依赖了这个jar,又单独依赖了这个第三方jar所依赖的不同版本的jar文件时,会出现java.lang.NoSuchFieldError,或ClassNotFoundException异常。这样的问题很难从包名分辨出是哪两个jar冲突,同时也绕过了maven的版本控制。下面来详细的描述问题场景:
项目中同时依赖两个jar
<dependency>
<groupId>com.fasterxml.jackson.core</groupId>
<artifactId>jackson-annotations</artifactId>
<version>2.7.4</version>
</dependency>
<dependency>
<groupId>org.apache.calcite</groupId>
<artifactId>calcite-avatica</artifactId>
<version>1.6.0</version>
</dependency>
calcite-avatica-1.6.0.jar里依赖包含了jackson-annotations-2.1.1.jar
jackson-annotations-2.7.4.jar里面的JsonInclude类
这个时候运行代码,会出现以下错误:
Causedby: java.lang.NoSuchFieldError: USE_DEFAULTS
atcom.fasterxml.jackson.annotation.JsonInclude$Value.<clinit>(JsonInclude.java:205)
atcom.fasterxml.jackson.databind.cfg.MapperConfig.<clinit>(MapperConfig.java:45)
atcom.fasterxml.jackson.databind.ObjectMapper.<init>(ObjectMapper.java:543)
atcom.fasterxml.jackson.databind.ObjectMapper.<init>(ObjectMapper.java:460)
atorg.springframework.http.converter.json.Jackson2ObjectMapperBuilder.build(Jackson2ObjectMapperBuilder.java:553)
同一个classpath下存在两个版本的jackson-annotations,这个两个版本存在类和字段的删除和新增,而不同的类加载器加载的顺序是不可确定的,这样在实际的运行中,难免会遇到加载错误的类版本。
既然出现了版本的冲突,现在介绍下如何快速的找到冲突的jar包文件,移除冲突的版本。
写个打印class的源jar文件的路径的辅助类
/**
* Created by shaowei on 2017/7/4.
* 打印出指定class做在的jar包路径
*/
public class PrintClassSource {
public PrintClassSource() {
ProtectionDomain pd =JsonInclude.Include.class.getProtectionDomain();
System.out.println("-------------------:" +pd.getCodeSource().getLocation());
}
}
如果像上面的报错例子的是使用spirng的web项目,在实例化类的时候报错的,则可以将打印辅助类放到spring的xml文件中进行实例化加载
<beanid="printClassSource"class="cn.sw.study.web.PrintClassSource"></bean>
如果是普通的java应用,则可以将上面代码加到你的执行代码中,打印出来。
-------------------:file:/E:/work/datai/code_study/study-master/study-web/target/study-web/WEB-INF/lib/calcite-avatica-1.6.0.jar
通过上面打印信息则可以看出,此时加载的是calcite-avatica-1.6.0.jar中的JsonInclude.Include类,而USE_DEFAULTS字段是从jackson-annotations的2.6版本开始有这个字段的,calcite-avatica-1.6.0.jar里的jackson-annotations是2.1.1版本,是没有这个字段的。