解决jar包冲突通用方法汇总

1.问题

先是遇到一个比较奇怪的问题：

Handler processing failed; nested exception is java.lang.NoSuchMethodError: org.apache.http.impl.client.HttpClientBuilder.setSSLContext(Ljavax/net/ssl/SSLContext;)Lorg/apache/http/impl/client/HttpClientBuilder

所有发送https请求的地方都会报这个错误，查看代码，并没有用到HttpClientBuilder，但是可以找到是在使用httpsclient的时候用了：

HttpClients.custom().setSSLContext(context).build()

2.想法与实践

1.证书出错？

首先可以确定是https请求出错，因为是最近替换了新的证书，所以怀疑是ssl证书出问题了.
然而，换回原来的证书还是会出错，卒。

2.https请求出错？

试了在本地使用https请求，完全正常，只有怀疑是上传到服务器上jar包冲突了。

3.jar包冲突

因为新添加了一个友商的jar包，所以怀疑是这个包冲突了，去掉这个包，未报错。证明确实是冲突了。

3.问题解决

1.使用统一的包

查看友商的包发现他使用的4.4的httpclient包，我使用的是4.5的包，所以冲突了。
反馈给友商，并不能让他使用4.5的jar包，然后我打算使用4.4的包，但是4.4的包又没有我使用的那个http方法，所以必须解决jar包冲突问题。

2.通用方法

a.使用IDEA查看依赖关系,如果有冲突可以右键Exclude

idea会自动帮你把冲突的jar包合并，pom代码里面会变成这样：

<dependency>
            <groupId>junit</groupId>
            <artifactId>junit</artifactId>
            <version>4.12</version>
            <scope>test</scope>
            <exclusions>
                <exclusion>
                    <artifactId>hamcrest-core</artifactId>
                    <groupId>org.hamcrest</groupId>
                </exclusion>
            </exclusions>
        </dependency>

b.自己修改pom文件

自己修改代码如上，添加一个exclusion就可以了：
我引入的是外部jar包，所以加了一个systemPath标签，和scope标签。
很遗憾，并不能解决问题，仍然是本地是正确的，但是线上是错误的，这个时候我推测是maven项目在构建的时候优先引入了外部的jar包。

<dependency>
            <groupId>auth</groupId>
            <artifactId>open-sdk</artifactId>
            <version>1.3.2</version>
            <exclusions>
                <exclusion>
                    <artifactId>slf4j-api</artifactId>
                    <groupId>org.slf4j</groupId>
                </exclusion>
            </exclusions>
            <scope>system</scope>
            <systemPath>${basedir}/src/main/webapp/WEB-INF/lib/open-sdk-1.3.2.jar</systemPath>
        </dependency>

补充一下，scope标签用法：

• compile
  默认的scope，表示 dependency 都可以在生命周期中使用。而且，这些dependencies 会传递到依赖的项目中。适用于所有阶段，会随着项目一起发布
• provided
  跟compile相似，但是表明了dependency 由JDK或者容器提供，例如Servlet AP和一些Java EE APIs。这个scope 只能作用在编译和测试时，同时没有传递性。
• runtime
  表示dependency不作用在编译时，但会作用在运行和测试时，如JDBC驱动，适用运行和测试阶段。
• test
  表示dependency作用在测试时，不作用在运行时。 只在测试时使用，用于编译和运行测试代码。不会随项目发布。
• system
  跟provided 相似，但是在系统中要以外部JAR包的形式提供，maven不会在repository查找它。

c.修改maven载入jar包顺序

maven加载jar包的顺序是按照路径长短来的，优先加载短路径的jar包，所以我尝试了一下把引入的包名增长了变成openwerwerwerwer-sdk-1.3.2.jar：

<dependency>
            <groupId>auth</groupId>
            <artifactId>openwerwerwerwer-sdk</artifactId>
            <version>1.3.2</version>
            <exclusions>
                <exclusion>
                    <artifactId>slf4j-api</artifactId>
                    <groupId>org.slf4j</groupId>
                </exclusion>
            </exclusions>
            <scope>system</scope>
            <systemPath>${basedir}/src/main/webapp/WEB-INF/lib/openwerwerwerwer-sdk-1.3.2.jar</systemPath>
        </dependency>

上线部署，成功！

4.总结

开发的过程中，线上环境和线下生产环境可能会有不同，需要优先到预装环境上测试一下。
测试的时候，优先搞清楚每一步错误的原因，有益于提高debug的效率，避免走很多弯路。