1. 程式人生 > >Maven解決jar包依賴衝突

Maven解決jar包依賴衝突

使用maven最煩人的可能就是類包之間的版本衝突引發的問題了,類包衝突的一個很大的原因即產類包之間的間接依賴引起的。每個顯式宣告的類包都會依賴於一些其它的隱式類包,這些隱式的類包會被maven間接引入進來,因而可能造成一個我們不想要的類包的載入,嚴重的甚至會引起類包之間的衝突。 

要解決這個問題,首先就是要檢視pom.xml顯式和隱式的依賴類包,然後通過這個類包樹找出我們不想要的依賴類包,手工將其排除在外就可以了。 

下面,通過一個例子來說明:
我的專案使用testng進行測試,使用了untilis,由於unitils的類包會隱式依賴於junit,這是我不想看到的,下面的目的就是找出junit會誰隱式載入了,然後exculte掉它。

通過idea的maven依賴分析將不需要的依賴exclude掉

開啟maven的pom.xml,在某個<dependency>中通過右鍵選單:maven->show dependency 開啟分析的圖形化頁面,如下所示:


通過選單的exclude即解決這個間接依賴。
通過這個依賴樹,我們還可以看到Junit還通過“unitils-spring”的依賴間接載入了,如下所示: 



從上面的依賴樹中,我們可以看出junit通過unitils-spring的unitils-database間接引入了,由於我的專案都不需要資料庫的測試,因此,可以把unitils-database項整個exclude掉。
如果有jar包衝突,idea會用紅色標明,滑鼠點選衝突狀態的圖示,會有紅色虛線標明是跟哪個jar包衝突了,在其上右鍵Exclude則可以快速的排除依賴。可見,idea的jar包檢視和衝突排除比eclipse 外掛要好,但idea下沒有找到明顯輸入名字查詢對應jar包的功能,只找到這個,然後輸入字母就能夠篩選了
下面,是處理完成後的pom.xml關鍵片斷: 

Xml程式碼  收藏程式碼
  1.     <dependency>  
  2.         <groupId>org.unitils</groupId>  
  3.         <artifactId>unitils-testng</artifactId>  
  4.         <version>${unitils.version}</version>  
  5.         <scope>test</scope>  
  6.         <exclusions>
      
  7.             <exclusion>  
  8.                 <artifactId>junit</artifactId>  
  9.                 <groupId>junit</groupId>  
  10.             </exclusion>  
  11.         </exclusions>  
  12.     </dependency>  
  13.     <dependency>  
  14.         <groupId>org.unitils</groupId>  
  15.         <artifactId>unitils-spring</artifactId>  
  16.         <version>${unitils.version}</version>  
  17.         <scope>test</scope>  
  18.         <exclusions>  
  19.             <exclusion>  
  20.                 <artifactId>unitils-database</artifactId>  
  21.                 <groupId>org.unitils</groupId>  
  22.             </exclusion>  
  23.         </exclusions>  
  24.     </dependency>  
  25. </dependencies>  

這樣,被間接隱式引入的junit就被我們exclude在外了。 

有時通過idea的依賴分析工具產生的樹不夠全,這時就需要使用mvn dependency:tree來檢視依賴樹了。 
通過mvn dependency:tree 檢視依賴樹 

引用 mvn dependency:tree
     mvn dependency:tree >xxx.txt


以下是使用這個工具產生的依賴樹: 
引用 E:\01workspace\chenxh\09research\rop\rop>mvn dependency:tree 
[WARNING] 
[WARNING] Some problems were encountered while building the effective settings 
[WARNING] 'pluginRepositories.pluginRepository.id' must not be 'local', this identifier is reserved for the local re 
tory, using it for other repositories will corrupt your repository metadata. @ C:\Users\Administrator\.m2\settings.x 
[WARNING] 
[INFO] Scanning for projects... 
[INFO] 
[INFO] ------------------------------------------------------------------------ 
[INFO] Building rop 1.0-SNAPSHOT 
[INFO] ------------------------------------------------------------------------ 
[INFO] 
[INFO] --- maven-dependency-plugin:2.1:tree (default-cli) @ rop --- 
[INFO] com.rop:rop:jar:1.0-SNAPSHOT 
[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.0.0-RC2:compile 
[INFO] |  +- com.fasterxml.jackson.core:jackson-core:jar:2.0.0-RC2:compile 
[INFO] |  +- com.fasterxml.jackson.core:jackson-annotations:jar:2.0.0-RC2:compile 
[INFO] |  +- com.fasterxml.jackson.core:jackson-databind:jar:2.0.0-RC2:compile 
[INFO] |  +- com.fasterxml.jackson.module:jackson-module-jaxb-annotations:jar:2.0.0-RC2:compile 
[INFO] |  \- org.codehaus.woodstox:stax2-api:jar:3.1.1:compile 
[INFO] |     \- javax.xml.stream:stax-api:jar:1.0-2:compile 
[INFO] +- org.slf4j:slf4j-api:jar:1.6.1:compile 
[INFO] +- org.slf4j:slf4j-log4j12:jar:1.6.1:compile 
[INFO] +- log4j:log4j:jar:1.2.16:compile 
[INFO] +- org.springframework:spring-core:jar:3.1.1.RELEASE:compile 
[INFO] |  +- org.springframework:spring-asm:jar:3.1.1.RELEASE:compile 
[INFO] |  \- commons-logging:commons-logging:jar:1.1.1:compile 
[INFO] +- org.springframework:spring-context:jar:3.1.1.RELEASE:compile 
[INFO] |  +- org.springframework:spring-aop:jar:3.1.1.RELEASE:compile 
[INFO] |  +- org.springframework:spring-beans:jar:3.1.1.RELEASE:compile 
[INFO] |  \- org.springframework:spring-expression:jar:3.1.1.RELEASE:compile 
[INFO] +- org.springframework:spring-context-support:jar:3.1.1.RELEASE:compile 
[INFO] +- org.springframework:spring-web:jar:3.1.1.RELEASE:compile 
[INFO] |  \- aopalliance:aopalliance:jar:1.0:compile 
[INFO] +- org.springframework:spring-test:jar:3.1.1.RELEASE:compile 
[INFO] +- org.springframework:spring-webmvc:jar:3.1.1.RELEASE:compile 
[INFO] +- org.testng:testng:jar:6.3:test 
[INFO] |  +- org.beanshell:bsh:jar:2.0b4:test 
[INFO] |  +- com.beust:jcommander:jar:1.12:test 
[INFO] |  \- org.yaml:snakeyaml:jar:1.6:test 
[INFO] +- org.mockito:mockito-all:jar:1.8.5:test 
[INFO] +- javax.servlet:servlet-api:jar:2.5:provided 
[INFO] +- org.unitils:unitils-core:jar:3.3:test 
[INFO] |  +- commons-lang:commons-lang:jar:2.3:test 
[INFO] |  +- commons-collections:commons-collections:jar:3.2:test 
[INFO] |  \- ognl:ognl:jar:2.6.9:test 
[INFO] +- org.unitils:unitils-testng:jar:3.3:test 
[INFO] |  \- org.testng:testng:jar:jdk15:5.8:test 
[INFO] |     \- junit:junit:jar:3.8.1:test 
[INFO] \- org.unitils:unitils-spring:jar:3.3:test 
[INFO]    +- org.springframework:spring-tx:jar:2.5.2:test 
[INFO]    \- org.unitils:unitils-database:jar:3.3:test 
[INFO]       +- org.unitils:unitils-dbmaintainer:jar:3.3:test 
[INFO]       |  +- org.hibernate:hibernate:jar:3.2.5.ga:test 
[INFO]       |  |  +- net.sf.ehcache:ehcache:jar:1.2.3:test 
[INFO]       |  |  +- asm:asm-attrs:jar:1.5.3:test 
[INFO]       |  |  +- dom4j:dom4j:jar:1.6.1:test 
[INFO]       |  |  +- antlr:antlr:jar:2.7.6:test 
[INFO]       |  |  +- cglib:cglib:jar:2.1_3:test 
[INFO]       |  |  \- asm:asm:jar:1.5.3:test 
[INFO]       |  \- org.dbunit:dbunit:jar:2.2.2:test 
[INFO]       |     +- junit-addons:junit-addons:jar:1.4:test 
[INFO]       |     |  +- xerces:xercesImpl:jar:2.6.2:test 
[INFO]       |     |  \- xerces:xmlParserAPIs:jar:2.6.2:test 
[INFO]       |     +- poi:poi:jar:2.5.1-final-20040804:test 
[INFO]       |     \- org.slf4j:slf4j-nop:jar:1.4.3:test 
[INFO]       +- commons-dbcp:commons-dbcp:jar:1.2.2:test 
[INFO]       |  \- commons-pool:commons-pool:jar:1.3:test 
[INFO]       \- org.springframework:spring-jdbc:jar:2.5.2:test 
[INFO] ------------------------------------------------------------------------ 
[INFO] BUILD SUCCESS 
[INFO] ------------------------------------------------------------------------ 
[INFO] Total time: 8.250s 
[INFO] Finished at: Fri Jun 08 09:08:09 CST 2012 
[INFO] Final Memory: 7M/245M 
[INFO] ------------------------------------------------------------------------
如果有衝突使用exclusions排除
我原來一個使用idea分析不出的隱式依賴就是通用mvn dependency:tree找到的。
總結

jar包衝突幾乎是每個Java程式設計師都會遇到的問題,而且特別是大工程,jar包各種依賴,經常性發生包衝突。通常會報這樣幾個執行時異常:

  • java.lang.NoSuchMehodError
  • java.lang.NoClassDefFoundError
這類問題十有八九都是jar包衝突引起,要解決jar包衝突問題,我們先了解下導致這個衝突的原因。

導致jar包衝突的原因

1、mvn的傳遞依賴特性:mvn編譯打包除了會引入直接申明的依賴,還會引入間接申明的依賴

2、mvn的依賴仲裁規則:

    1). 按照專案總控POM的DependencyManager版本宣告進行仲裁。
    2). 如無仲裁宣告,則按照依賴最短路徑確定版本。
    3). 若相同路徑,有嚴格區間限定的版本優先。
    4). 若相同路徑,無版本區間,則按照先入為主原則。

3、依賴的scope會影響依賴的影響範圍。


簡單衝突解決的三途徑!

1、根據報錯的class名或方法名定位到可能導致衝突的jar包,jar包衝突引入有幾種情況:

    1).  引入了這個jar包的多個版本,而mvn仲裁的時候取了錯誤的版本,這個版本本身就缺少正確的class或方法。

    2).  引入了不同座標但是具有同名class的多個jar,mvn載入class的順序差異會導致載入到錯誤的class。

2、通過mvn dependency:tree  >  tree.txt 匯出全部的依賴。 可以使用 -Dverbose 、-Dincludes或者-Dexcludes引數來精確定位導致衝突的jar包。 

3、找到需要排除的依賴jar包,通過mvn仲裁優先的方法定義正確的jar包,或者通過exclusion的方式排除錯誤的jar包。

4.溫馨提示:另外在專案開發中jar儘量按需引入,系統管理起來,別什麼都不管直接加包進來,這樣也可以在一定程度上減少jar包衝突的風險。

相關推薦

Maven解決jar依賴衝突

使用maven最煩人的可能就是類包之間的版本衝突引發的問題了,類包衝突的一個很大的原因即產類包之間的間接依賴引起的。每個顯式宣告的類包都會依賴於一些其它的隱式類包,這些隱式的類包會被maven間接引入進來,因而可能造成一個我們不想要的類包的載入,嚴重的甚至會引起類包之間的衝突。 要解決這個問題,首先就是要檢視

Maven 解決Jar版本衝突

今天遇到一個小問題。在使用apache-commons-codec包進行編碼/解碼的時候,用到了Base64類的decodeBase64(String base64String)方法,這個方法在1.4版中才提供。而我們的工程中對codec存在兩個

maven解決jar版本衝突

Maven對於新手來說是《步步驚心》,因為它包羅永珍,博大精深,因為當你初來乍到時,你就像一個進入森林的陌生訪客一樣迷茫。 Maven對於老手來說是《真愛配方》,因為它無所不能,利如刀鋒,使用Maven做開發,如飲美酒如悅美人。 Maven對於新手來說,最痛苦的一件事莫過於

maven】排除mavenjar依賴解決過程 例子:spring cloud啟動zipkin,報錯maven依賴jar衝突 Class path contains multiple SLF4J bindings.

一直對於maven中解決jar包依賴問題的解決方法糾結不清: 下面這個例子可以說明一個很簡單的解決方法:     專案啟動報錯: Connected to the target VM, address: '127.0.0.1:59412', transport: 'sock

手動編寫jar依賴關係,記對於Mavenjar依賴錯誤問題的一次解決

專案中需要使用<c:**>標籤,因此需要引入jstl庫,而jstl庫又依賴於standard庫,所以可以從maven中加入jar包依賴。但是我加入後確是出現了波浪線,標籤依然不能引用。這樣的狀況碰見了n次,尤其是對於剛學習maven的小白來說,總是不能正確的從maven倉庫中下載ja

maven的jstl-api的jar與Tomcat的jar依賴衝突

maven的jstl-api的jar包所依賴的jar包與Tomcat的jar包依賴衝突 jstl-api的編譯依賴有: tomcat裡面同樣有servlet-api和jsp-api, 都有時就會發生衝突導致錯誤。 所以對jstl-

Maven解決jar衝突

在使用Maven時,經常會遇到jar包衝突的問題,解決辦法: 在pom.xml檔案中使用maven的exclusions工具,語法如下: 避免hadoop-client-2.2.0.jar引入hado

Maven 解決jar衝突的原理

管理包依賴是 Maven 核心功能之一,下面通過如何引入 jar 包;如何解析 jar 包依賴;包衝突是如何產生;如何解決包衝突;依賴管理解決什麼問題;什麼是依賴範圍;使用包依賴的最佳實踐等 6 個問題來介紹。 如何引入 jar 包 在程式碼開發時,如果需要使用第三方 jar 包提供的類庫,那麼需要在 pom

maven新增jar依賴

國外映象網速慢,因此首先更改aliyun映象 maven根目錄--->config--->setting.xml,在<mirrors>標籤內新增 <mirror> <id>nexus-aliyun

Failed to read artifact descriptor for xxx:jarMaven項目jar依賴配置的問題解決

描述 tin ava 打開 文件 我們 記事本 last .com 在開發的過程中,尤其是新手,我們經常遇到Maven下載依賴jar包的問題,也就是遇到“Failed to read artifact descriptor for xxx:jar”的

mavenjar衝突-記一次衝突解決

1、請到pom.xml檔案所在的目錄(包含父子目錄)下分別執行下面的命令排查是什麼原因導致fastjson版本不正確: mvn dependency:tree -Dverbose -Dincludes=com.alibaba:fastjson 2、配合excusions標籤排除過時的包 &n

解決maven中servlet-api.jar和容器自帶的servlet-api.jar依賴衝突

在學習maven時,給maven新增tomcat7-maven-plugin外掛後,新建了一個專案並且嘗試執行,但出現下列異常:   通過在百度的搜尋,得知這是由於servlet-api.jar和容器自帶的servlet-api.jar產生了依賴衝突。但是,在百度中沒有

maven專案jar衝突解決方案

上圖中顯示的是servlet2.3而不是3.0。 解決方法:        網上都說servlet-api衝突是因為專案部署的時候WEB-INFO/lib下面的servlet-api和servlet中的servlet-api產生衝突,其實我的不然。因為我的專案是用maven管理的,在pom.

怎麼解決maven管理jar衝突問題

maven管理jar包依賴的時候,假如你的依賴包A需要間接依賴B的1.0版本,而你的工程裡又需要用到B的2.0版本,這個時候就可能會出現執行時jar衝突的異常,會報java.lang.NoSuchMethodError 或者 java.lang.ClassNotFoundE

maven工具解決jar衝突問題或重複載入問題

在使用maven開發專案的過程中,經常會遇到jar包重複載入或者jar包衝突的問題的,但是由於有些jar是由於maven的依賴載入自動載入進來的, 而不是開發者自己配置的,特別是當專案中pom中配置的jar包依賴本身很多時,開發者靠自己的經驗,有時很難找出是哪

解決Maven依賴衝突導致IDEA中Maven報紅色警告線(omitted for conflict with...)問題

情景再現: 今天工作時用IDEA從svn上down個專案,完成後點選重新匯入所有maven專案後,maven報了紅色警告線錯誤,如圖: 最終的錯誤資訊為:“omitted for conflict with 1.1”。大致意思是這個javax.activation:activ

eclipse利用maven工具解決jar衝突問題

專案中出現的問題如下: Caused by: java.lang.NoClassDefFoundError: Could not initialize class org.apache.log4j.Log4jLoggerFactory 原因 :  maven自動載

maven專案解決jar衝突的四種方式

依賴一個jar包往往會下載相互關聯的jar包這就是依賴傳遞 依賴傳遞經常出現ja包衝突,解決方案:直接排除指定的jar包 1、排除原則 <exclusions> <exc

IntelliJ IDEA查詢依賴關係,解決jar衝突

<dependencies> <dependency> <groupId>com.fasterxml.jackson.core</groupId> <artifactId>jackson-databind<

Mavenjar衝突解決

用了Maven之後,不得不說它是一個很好的用於專案構建,管理,jar包管理的工具,但是使用過程中,相信各位也遇到過jar衝突這種煩人的問題,特別是大專案,依賴的jar包比較多,很容易造成jar包衝突,jar包衝突的一個很大的原因即產類包之間的間接依賴引起的。每個顯式宣告的類包