Jar包冲突如何快速解决

在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版本，是没有这个字段的。