java 依賴包沖突，使用maven的Shade方式解決

[TOC]

問題描述

程序中同時(shí)使用了hadoop工具包與ElasticSearch工具導(dǎo)致jar包。
程序報(bào)錯(cuò)：

java.lang.NoSuchMethodError: com.google.common.util.concurrent.MoreExecutors.directExecutor()Ljava/util/concurrent/Executor;

內(nèi)容如下：

java.lang.NoSuchMethodError: com.google.common.util.concurrent.MoreExecutors.directExecutor()Ljava/util/concurrent/Executor;
at org.elasticsearch.threadpool.ThreadPool.(ThreadPool.java:190)

原因分析

通過對(duì)上述錯(cuò)誤進(jìn)行g(shù)oogle可以判斷是由于Elasticsearch引用的guava包版本不正確而導(dǎo)致。程序中hadoop依賴的guava包版本為11版本，而ES所需要的版本為18以上。因此我們首先在maven中將guava的版本強(qiáng)制指定為18版本，但是將程序打包后上傳到linux生成環(huán)境程序仍然無法正常運(yùn)行。

解決方案

根據(jù)[官網(wǎng)博客][3]說明，我們將ElasticSearch以及它的相關(guān)依賴包以shade的打包成一個(gè)獨(dú)立的jar包，對(duì)應(yīng)ElasticSearch相關(guān)類的使用均從此jar包引用。

1、shade Elasticsearch包

• 首先創(chuàng)建新的maven工程，pom.xml文件如下：

<groupId>my.elasticsearch</groupId>
    <artifactId>es-shaded</artifactId>
    <version>1.0-SNAPSHOT</version>
    <properties>
        <elasticsearch.version>2.1.2</elasticsearch.version>
    </properties>
    <dependencies>
        <dependency>
            <groupId>org.elasticsearch</groupId>
            <artifactId>elasticsearch</artifactId>
            <version>${elasticsearch.version}</version>
        </dependency>
        <dependency>
            <groupId>com.google.guava</groupId>
            <artifactId>guava</artifactId>
            <version>18.0</version>
        </dependency>
    </dependencies>
    <build>
        <plugins>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-shade-plugin</artifactId>
                <version>2.4.1</version>
                <configuration>
                    <createDependencyReducedPom>false</createDependencyReducedPom>
                </configuration>
                <executions>
                    <execution>
                        <phase>package</phase>
                        <goals>
                            <goal>shade</goal>
                        </goals>
                        <configuration>
                            <relocations>
                                <relocation>
                                    <pattern>com.google.guava</pattern>
                                    <shadedPattern>my.elasticsearch.guava</shadedPattern>
                                </relocation>
                                <relocation>
                                    <pattern>org.joda</pattern>
                                    <shadedPattern>my.elasticsearch.joda</shadedPattern>
                                </relocation>
                                <relocation>
                                    <pattern>com.google.common</pattern>
                                    <shadedPattern>my.elasticsearch.common</shadedPattern>
                                </relocation>
                                <relocation>
                                    <pattern>org.elasticsearch</pattern>
                                    <shadedPattern>my.elasticsearch</shadedPattern>
                                </relocation>
                            </relocations>
                            <transformers>
                                <transformer implementation="org.apache.maven.plugins.shade.resource.ManifestResourceTransformer" />
                            </transformers>
                        </configuration>
                    </execution>
                </executions>
            </plugin>
        </plugins>
    </build>

在pom.xml中我們指定了該項(xiàng)目依賴org.elasticsearch包，且版本為2.1.2，并強(qiáng)制指定了guava的版本為18（此處若不指定應(yīng)該也會(huì)自行依賴18以上的包，但并未進(jìn)行測(cè)試）。然后在build標(biāo)簽中可以看出，我們利用maven的shade工具完成打包情況如下：

• org.joda映射為my.elasticsearch.joda
• com.google.guava映射為my.elasticsearch.guava
• com.google.common映射為my.elasticsearch.common
• org.elasticsearch映射為my.elasticsearch

然后利用mvn clean install命令進(jìn)行打包得到es-shaded-1.0-SNAPSHOT.jar，創(chuàng)建一個(gè)屬于你自己版本的Elasticsearch包。之后將該包上傳到私服maven鏡像。

2、在工程中使用自己的Elasticsearch包

完成上數(shù)對(duì)Elasticsearch的打包之后，在自己工程中的pom.xml中，我們引用此包方式如下：

<dependencies>
       ...
    <dependency>
      <groupId>org.apache.hadoop</groupId>
      <artifactId>hadoop-client</artifactId>
      <version>${hadoop.version}</version>
    </dependency>
    <dependency>
      <groupId>org.apache.hive</groupId>
      <artifactId>hive-exec</artifactId>
      <version>${hive.version}</version>
    </dependency>
    <dependency>
      <groupId>org.antlr</groupId>
      <artifactId>ST4</artifactId>
      <version>4.0.8</version>
      <scope>compile</scope>
    </dependency>
    <dependency>
      <groupId>my.elasticsearch</groupId>
      <artifactId>es-shaded</artifactId>
      <version>1.0-SNAPSHOT</version>
    </dependency>
  </dependencies>

在使用上述方式引用了Elasticsearch包之后，在程序中我們可以這樣對(duì)Elasticsearch包進(jìn)行引用
代碼如下：

import my.elasticsearch.ElasticsearchException;
import my.elasticsearch.action.bulk.BulkItemResponse;
import my.elasticsearch.action.bulk.BulkRequestBuilder;
import my.elasticsearch.action.bulk.BulkResponse;
import my.elasticsearch.action.index.IndexRequest;
import my.elasticsearch.client.transport.NoNodeAvailableException;

這樣確保了我們使用的elasticsearch包是我們之前創(chuàng)建的。對(duì)Elasticsearch所依賴版本的 joda相關(guān)包的引用方式也是類似：

import my.elasticsearch.joda.time.DateTime;

這樣就不會(huì)出現(xiàn)Elasticsearch依賴包不正確的情況。

參考文獻(xiàn)

[1] https://www.elastic.co/blog/to-shade-or-not-to-shade
[2] http://www.cnblogs.com/bigbigtree/p/6668542.html
[3]:https://www.elastic.co/blog/to-shade-or-not-to-shade