Maven類包衝突終極解決小技若干

時間 2019-12-08

標籤 maven 衝突終極解決小技若干欄目 Maven 简体版

原文原文鏈接

引用java

若是你愛他，就請讓他用Maven，由於那裏是天堂，若是你恨他，就請讓他用Maven，由於那裏是地獄.web

Maven對於新手來講是《步步驚心》，由於它一應俱全，博大精深，由於當你初來乍到時，你就像一個進入森林的陌生訪客同樣迷茫。

Maven對於老手來講是《真愛配方》，由於它無所不能，利如刀鋒，使用Maven作開發，如飲美酒如悅美人。

Maven對於新手來講，最痛苦的一件事莫過於包之間的衝突，因爲Maven的依賴傳遞性，當你引入一個依賴類時，其身後的依賴類也一塊兒如過江之鯽紛至沓來了。

舉個栗子

A依賴於B及C，而B又依賴於X、Y，而C依賴於X、M，則A除引B及C的依賴包下，還會引入X，Y，M的依賴包（通常狀況下了，Maven可經過<scope>等若干種方式控制傳遞依賴）。

這裏有一個須要特別注意的，即B和C同時依賴於X，假設B依賴於X的1.0版本，而C依賴於X的2.0版本，A究竟依賴於X的1.0仍是2.0版本呢？

這就看Classloader的加載順序了，假設Classloader先加載X_1.0，而它就不會再加載X_2.0了，若是A偏偏但願使用X_2.0呢，血案就這樣不期而遇了。

我常掄的三板斧

第一板斧:找到傳遞依賴的鬼出在哪裏？

dependency:tree是把照妖照，pom.xml用它照照，全部傳遞性依賴都將無處遁形，而且會以層級樹方式展示，很是直觀。

如下就是執行dependency:tree後的一個輸出：
spring

引用api

[INFO] --- maven-dependency-plugin:2.1:tree (default-cli) @ euler-foundation ---
[INFO] com.hsit:euler-foundation:jar:0.9.0.1-SNAPSHOT
[INFO] +- com.rop:rop:jar:1.0.1:compile
[INFO] | +- org.slf4j:slf4j-api:jar:1.7.5:compile
[INFO] | +- org.slf4j:slf4j-log4j12:jar:1.7.5:compile
[INFO] | +- log4j:log4j:jar:1.2.16:compile
[INFO] | +- commons-lang:commons-lang:jar:2.6:compile
[INFO] | +- commons-codec:commons-codec:jar:1.6:compile
[INFO] | +- javax.validation:validation-api:jar:1.0.0.GA:compile
[INFO] | +- org.hibernate:hibernate-validator:jar:4.2.0.Final:compile
[INFO] | +- org.codehaus.jackson:jackson-core-asl:jar:1.9.5:compile
[INFO] | +- org.codehaus.jackson:jackson-mapper-asl:jar:1.9.5:compile
[INFO] | +- org.codehaus.jackson:jackson-jaxrs:jar:1.9.5:compile
[INFO] | +- org.codehaus.jackson:jackson-xc:jar:1.9.5:compile
[INFO] | \- com.fasterxml.jackson.dataformat:jackson-dataformat-xml:jar:2.2.3:compile
[INFO] |     +- com.fasterxml.jackson.core:jackson-core:jar:2.2.3:compile
[INFO] |     +- com.fasterxml.jackson.core:jackson-annotations:jar:2.2.3:compile
[INFO] |     +- com.fasterxml.jackson.core:jackson-databind:jar:2.2.3:compile
[INFO] |     +- com.fasterxml.jackson.module:jackson-module-jaxb-annotations:jar:2.2.3:compile
[INFO] |     \- org.codehaus.woodstox:stax2-api:jar:3.1.1:compile
[INFO] |        \- javax.xml.stream:stax-api:jar:1.0-2:compile
緩存

剛纔吹噓dependency:tree時，我用到了「無處遁形」，其實有時你會發現簡單地用dependency:tree每每並不能查看到全部的傳遞依賴。不過若是你真的想要看全部的，必須得加一個-Dverbose參數，這時就一定是最全的了。

全是全了，但顯示出來的東西太多，頭暈目眩，有沒有好法呢？固然有了，加上Dincludes或者Dexcludes說出你喜歡或討厭，dependency:tree就會幫你過濾出來：
app

引用maven

Dincludes=org.springframework:spring-txide

過濾串使用groupId:artifactId:version的方式進行過濾，能夠不寫全啦，如：
工具

Java代碼測試

mvn dependency:tree -Dverbose -Dincludes=asm:asm

就會出來asm依賴包的分析信息：

引用

[INFO] --- maven-dependency-plugin:2.1:tree (default-cli) @ ridge-test ---
[INFO] com.ridge:ridge-test:jar:1.0.2-SNAPSHOT
[INFO] +- asm:asm:jar:3.2:compile
[INFO] \- org.unitils:unitils-dbmaintainer:jar:3.3:compile
[INFO]    \- org.hibernate:hibernate:jar:3.2.5.ga:compile
[INFO]       +- cglib:cglib:jar:2.1_3:compile
[INFO]       | \- (asm:asm:jar:1.5.3:compile - omitted for conflict with 3.2)
[INFO]       \- (asm:asm:jar:1.5.3:compile - omitted for conflict with 3.2)
[INFO] ------------------------------------------------------------------------

對asm有依賴有一個直接的依賴(asm:asm:jar:3.2)還有一個傳遞進入的依賴(asm:asm:jar:1.5.3)

第二板斧:將不想要的傳遞依賴剪除掉

承上，假設咱們不但願asm:asm:jar:1.5.3出現，根據分析，咱們知道它是經由org.unitils:unitils-dbmaintainer:jar:3.3引入的，那麼在pom.xml中找到這個依賴，作其它的調整：

Xml代碼

<dependency>
<groupId>org.unitils</groupId>
<artifactId>unitils-dbmaintainer</artifactId>
<version>${unitils.version}</version>
<exclusions>
<exclusion>
<artifactId>dbunit</artifactId>
<groupId>org.dbunit</groupId>
</exclusion>
<exclusion>
<artifactId>asm</artifactId>
<groupId>asm</groupId>
</exclusion>
</exclusions>
</dependency>

再分析一下，你能夠看到傳遞依賴沒有了：

Xml代碼

[INFO]
[INFO] --- maven-dependency-plugin:2.1:tree (default-cli) @ ridge-test ---
[INFO] com.ridge:ridge-test:jar:1.0.2-SNAPSHOT
[INFO] \- asm:asm:jar:3.2:compile
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS

第三板斧:查看運行期類來源的JAR包

有時，你覺得解決了，可是恰恰仍是報類包衝突（典型症狀是java.lang.ClassNotFoundException或Method不兼容等異常），這時你能夠設置一個斷點，在斷點處經過下面這個我作的工具類來查看Class所來源的JAR包：

Java代碼

package com.ridge.util;
import java.io.File;
import java.net.MalformedURLException;
import java.net.URL;
import java.security.CodeSource;
import java.security.ProtectionDomain;
/**
* @author : chenxh
* @date: 13-10-31
*/
public class ClassLocationUtils {
/**
* 獲取類全部的路徑
* @param cls
* @return
*/
public static String where(final Class cls) {
if (cls == null)throw new IllegalArgumentException("null input: cls");
URL result = null;
final String clsAsResource = cls.getName().replace('.', '/').concat(".class");
final ProtectionDomain pd = cls.getProtectionDomain();
if (pd != null) {
final CodeSource cs = pd.getCodeSource();
if (cs != null) result = cs.getLocation();
if (result != null) {
if ("file".equals(result.getProtocol())) {
try {
if (result.toExternalForm().endsWith(".jar") ||
result.toExternalForm().endsWith(".zip"))
result = new URL("jar:".concat(result.toExternalForm())
.concat("!/").concat(clsAsResource));
else if (new File(result.getFile()).isDirectory())
result = new URL(result, clsAsResource);
}
catch (MalformedURLException ignore) {}
}
}
}
if (result == null) {
final ClassLoader clsLoader = cls.getClassLoader();
result = clsLoader != null ?
clsLoader.getResource(clsAsResource) :
ClassLoader.getSystemResource(clsAsResource);
}
return result.toString();
}
}

隨便寫一個測試，設置好斷點，在執行到斷點處按alt+F8動態執行代碼（intelij idea），假設咱們輸入：

Java代碼

ClassLocationUtils.where(org.objectweb.asm.ClassVisitor.class)

便可立刻查出類對應的JAR了：

這就是org.objectweb.asm.ClassVisitor類在運行期對應的JAR包，若是這個JAR包版本不是你指望你，就說明是你的IDE緩存形成的，這時建議你Reimport一下maven列表就能夠了，以下所示(idea)：

Reimport一下，IDE會強制根據新的pom.xml設置從新分析並加載依賴類包，以獲得和pom.xml設置相同的依賴。（這一步很是重要哦，常常項目組pom.xml是相同的，可是就是有些人能夠運行，有些人不能運行，俗稱人品問題，其實都是IDE的緩存形成的了）

相關標籤/搜索

每日一句

每一个你不满意的现在，都有一个你没有努力的曾经。