SpringBoot解決jar包沖突的問題,簡單有效
SpringBoot解決jar包沖突
今天SpringBoot項目打包發(fā)現(xiàn)一直在報錯
包jar包沖突，找了好久才找到結(jié)果，期間遇到一片博客很討人厭，我這里想評論一下他（原因：我沒有博客園不能直接評論，所以這里寫一篇博客記錄一下，并提供正確的解決方案）
上圖：
說一下：首先，你給的方法很泛（不是煩沒打錯字）只是市面上大多數(shù)可以解決的套路，
再者，你給的解決方案并沒有真正的解決問題。所以我留下一句話：不喜勿噴。
SpringBoot事實上是很好的，jar包沖突的時候，它是有提醒你了的，啟動第一行就說了有多個類路徑jar包存在：Class path contains multiple SLF4J bindings.
SpringBoot適合于小團隊及個人開發(fā)。是比較方便的。
為什么我要寫這篇博客呢，因為我看到jar沖突的真正原因后，很生氣，因為原因并不一定在SpringBoot 我這里查出的是騰訊云的cos-api也引入的了日志jar，所以導致沖突，這里是SpringBoot引入cos-api，你就說SpringBoot，如果SpringBoot是被被人引入的，你是不是也要說其他的工具不好呢？？？再者不好你為什么要用，要記錄？？？這只不過是想比較而言，技術沒有老舊，沒有好壞，只有喜歡，不喜歡，很多時候有些公司用的還是一二十年前的技術，可能是有些原因不能更換，但是我相信，它能存在在這個世上并風靡一時，說明它一定有它的獨特之處。
接下來就是，
我查到的一個解決方案，可使用所有jar包沖突問題
以eclipse為例：
這樣的開發(fā)工具都會有一個功能：就是查詢jar包直接引入/jar包間接引入的功能
如果你不知道你使用的工具怎么找到這個查找頁面：百度搜索：eclipse 看引入jar 包的聯(lián)系（idea同理）
說實話idea的更清晰一些，它是圖形化界面
找到?jīng)_突的jar包，去除沖突的包即可
代碼如下：
<dependency> <groupId>com.qcloud</groupId> <artifactId>cos_api</artifactId> <version>5.5.3</version> <exclusions> <!-- <exclusion> <groupId>ch.qos.logback</groupId> <artifactId>logback-classic</artifactId> </exclusion> --> <exclusion> <groupId>org.slf4j</groupId> <artifactId>slf4j-log4j12</artifactId> </exclusion> </exclusions> </dependency>
聲明：我只是對SpirngBoot報不平，沒有對任何人做人身攻擊。不喜勿噴
spring boot jar沖突問題集錦
總結(jié)下spring boot項目搭建過程中，沖突解決的一些小經(jīng)驗
1、日志jar包沖突
1.1、日志主要是spring boot自帶spring-boot-starter-logging的排除
一是要用log4j2，二是xdcs不排除這個也會有沖突。(隱秘程度：低；重要程度：高)
<exclusion> <artifactId>spring-boot-starter-logging</artifactId> <groupId>org.springframework.boot</groupId> </exclusion>
1.2、引的日志jar頗多
可能會有別的jar里也帶了沖突的class，但是不影響啟動，屬于可排可不排。可能會導致測試環(huán)境起不來。（隱秘程度：低；重要程度：高）
//這是舉個例子 <exclusion> <artifactId>slf4j-log4j12</artifactId> <groupId>org.slf4j</groupId> </exclusion> SLF4J: Class path contains multiple SLF4J bindings. SLF4J: Found binding in [jar:file:/Users/xmly/.m2/repository/org/apache/logging/log4j/log4j-slf4j-impl/2.11.2/log4j-slf4j-impl-2.11.2.jar!/org/slf4j/impl/StaticLoggerBinder.class] SLF4J: Found binding in [jar:file:/Users/xmly/.m2/repository/org/slf4j/slf4j-log4j12/1.7.5/slf4j-log4j12-1.7.5.jar!/org/slf4j/impl/StaticLoggerBinder.class] SLF4J: See http://www.slf4j.org/codes.html#multiple_bindings for an explanation. SLF4J: Actual binding is of type [org.apache.logging.slf4j.Log4jLoggerFactory] //這是啟動時對應的報錯，經(jīng)檢驗，這個不影響啟動
2、本地ok，測試環(huán)境失敗之mainstay
發(fā)測試時，出現(xiàn)過mainstay的yml解析失敗的問題，maven helper排jar包并未顯示有沖突，tree搜索mainstay，發(fā)現(xiàn)了一些貓膩。passport-sso-api（0.0.14-M3，下面用到的也是這個版本）這個jar包里包含了這個mainstay的jar，最終導致了解析失敗。后續(xù)登錄驗證可以接下網(wǎng)關鑒權等方式，這個jar沖突應該就不會出現(xiàn)了。（隱秘程度：高；重要程度：中）
<exclusion> <artifactId>mainstay-rpc-thrift</artifactId> <groupId>com.ximalaya.mainstay</groupId> </exclusion>
3、本地ok，測試環(huán)境失敗之servlet
發(fā)測試時，出現(xiàn)過servlet2和spring boot內(nèi)置tomcat class重名沖突的問題,一般主要passport-sso-api和xdcs默認會帶這個，排掉即可（隱秘程度：中；重要程度：高）
<exclusion> <artifactId>servlet-api</artifactId> <groupId>javax.servlet</groupId> </exclusion>
4、本地ok，測試環(huán)境失敗之tomcat
發(fā)測試時，也出現(xiàn)過passport-sso-api這個jar包里包含的spring-instrument-tomcat和spring boot內(nèi)置tomcat沖突，排掉即可。后續(xù)登錄驗證可以接下網(wǎng)關鑒權等方式，這個jar沖突應該就不會出現(xiàn)了。（隱秘程度：高；重要程度：中）
<exclusion> <artifactId>spring-instrument-tomcat</artifactId> <groupId>org.springframework</groupId> </exclusion>
5、本地ok，測試環(huán)境失敗之spring asm
測試環(huán)境出現(xiàn)過passport-sso-api里spring asm與spring-boot-test-start沖突的情況，排掉排掉。passport-sso-api這個jar包含的jar比較多，后面建議用注解或者網(wǎng)關鑒權來做登錄控制。（隱秘程度：高；重要程度：中）
<exclusion> <artifactId>spring-asm</artifactId> <groupId>org.springframework</groupId> </exclusion>
6、萬惡的測試環(huán)境字節(jié)碼驗證失敗
之前發(fā)過一個前項目改造的spring boot項目就出現(xiàn)過，當時不以為意，讓jvm參數(shù)加了-noverify就沒管，后來發(fā)現(xiàn)很多項目都有這個問題，開始排查。之前看過jdk和aspectj有沖突的例子，就開始tree里搜aspectj，發(fā)現(xiàn)spring-boot-start-aop里引入了1.9.4版本的aspectjweaver,但是當時因為maven helper提示它沖突，就把它排了，后重新排掉所有1.7版本的aspectj，引入1.9.4版本的，解決。（隱秘程度：高；重要程度：高）
<dependency>
<groupId>org.aspectj</groupId>
<artifactId>aspectjrt</artifactId>
<version>${aspectj.version}</version>
</dependency>
<dependency>
<groupId>org.aspectj</groupId>
<artifactId>aspectjtools</artifactId>
<version>${aspectj.version}</version>
</dependency>
<dependency>
<groupId>org.aspectj</groupId>
<artifactId>aspectjweaver</artifactId>
<version>${aspectj.version}</version>
</dependency>
<exclusion>
<artifactId>*</artifactId>
<groupId>org.aspectj</groupId>
</exclusion>
7、日志不能正常輸出問題
排除，日志橋接混亂，后臺配置的日志格式不支持了
<exclusion>
<artifactId>slf4j-log4j12</artifactId>
<groupId>org.slf4j</groupId>
</exclusion>
Configuration:
status: info
Properties:
Property:
- name: log.level.console
value: info
- name: log.path
value: /var/XXX/weXXX
- name: project.name
value: weXXX
- name: log.pattern
value: "%-d{yyyy-MM-dd HH:mm:ss SS} [%c]-[%p] %m%n"
Appenders:
Console:
name: CONSOLE
target: SYSTEM_OUT
PatternLayout:
pattern: ${log.pattern}
RollingRandomAccessFile:
- name: APP_FILE
fileName: ${log.path}/${project.name}.log
filePattern: "${log.path}/${project.name}-%d{yyyy-MM-dd}.log"
PatternLayout:
pattern: ${log.pattern}
Filters:
ThresholdFilter:
- level: info
onMatch: ACCEPT
onMismatch: DENY
Policies:
TimeBasedTriggeringPolicy:
modulate: true
interval: 1
DefaultRolloverStrategy:
max: 30
Loggers:
Root:
level: info
AppenderRef:
- ref: CONSOLE
- ref: APP_FILE
Logger:
- name: app
level: info
additivity: false
AppenderRef:
- ref: CONSOLE
- ref: APP_FILE
8、本地打包正常
測試或者線上環(huán)境打包失敗，查看wrap.log日志，本地配置文件使用線上，打包測試；
spring-boot-maven-plugin插件放在靠后位置，不然打包失?。?/p>
<profile>
<id>uat</id>
<properties>
<profileActive>UatXXX</profileActive>
</properties>
<build>
<plugins>
<plugin>
<groupId>org.codehaus.mojo</groupId>
<artifactId>appassembler-maven-plugin</artifactId>
<version>2.0.0</version>
<configuration>
<configurationDirectory>conf</configurationDirectory>
<repositoryLayout>flat</repositoryLayout>
<useWildcardClassPath>true</useWildcardClassPath>
<daemons>
<daemon>
<id>${project.artifactId}</id>
<mainClass>com.XXXX.Application</mainClass>
<commandLineArguments>
<commandLineArgument>--spring.profiles.active=${profileActive}
</commandLineArgument>
</commandLineArguments>
<platforms>
<platform>jsw</platform>
</platforms>
<jvmSettings>
<!-- 啟動內(nèi)存配置 -->
<initialMemorySize>2048M</initialMemorySize>
<maxMemorySize>2048M</maxMemorySize>
<maxStackSize>128</maxStackSize>
<systemProperties>
<systemProperty>application.root=.</systemProperty>
<systemProperty>spring.application.name=${project.artifactId}
</systemProperty>
<systemProperty>spring.config.location=./conf/${profileActive}/
</systemProperty>
</systemProperties>
<extraArguments>
<extraArgument>-XX:MetaspaceSize=256M</extraArgument>
<extraArgument>-XX:MaxMetaspaceSize=256M</extraArgument>
<extraArgument>-XX:+UseG1GC</extraArgument>
<extraArgument>-XX:-OmitStackTraceInFastThrow</extraArgument>
<extraArgument>-XX:MaxGCPauseMillis=100</extraArgument>
<extraArgument>-XX:+ParallelRefProcEnabled</extraArgument>
<extraArgument>-XX:+HeapDumpOnOutOfMemoryError</extraArgument>
<extraArgument>-XX:+PrintCommandLineFlags</extraArgument>
<extraArgument>-XX:+PrintGCDetails</extraArgument>
<extraArgument>-XX:+PrintGCDateStamps</extraArgument>
<extraArgument>-verbose:class</extraArgument>
<extraArgument>-XX:+PrintClassHistogramBeforeFullGC</extraArgument>
<extraArgument>-XX:+PrintClassHistogramAfterFullGC</extraArgument>
<extraArgument>-XX:+PrintTenuringDistribution</extraArgument>
<extraArgument>-XX:+PrintHeapAtGC</extraArgument>
<extraArgument>-XX:+PrintGCApplicationStoppedTime</extraArgument>
<extraArgument>-XX:+PrintGCApplicationConcurrentTime</extraArgument>
<extraArgument>-Xloggc:/var/log/${project.artifactId}/gc-%t</extraArgument>
<extraArgument>-XX:+UseGCLogFileRotation</extraArgument>
<extraArgument>-XX:GCLogFileSize=10M</extraArgument>
<extraArgument>-XX:NumberOfGCLogFiles=10</extraArgument>
<extraArgument>-javaagent:/opt/jars/aspectjweaver-1.8.9.jar</extraArgument>
</extraArguments>
</jvmSettings>
<generatorConfigurations>
<generatorConfiguration>
<generator>jsw</generator>
<includes>
<include>linux-x86-64</include>
<include>macosx-universal-64</include>
</includes>
<configuration>
<property>
<name>configuration.directory.in.classpath.first</name>
<value>conf</value>
</property>
<property>
<name>wrapper.ping.timeout</name>
<value>60</value>
</property>
<property>
<name>set.default.REPO_DIR</name>
<value>lib</value>
</property>
<property>
<name>wrapper.logfile</name>
<value>/var/XXXX/${project.artifactId}/wrapper.YYYYMMDD.log</value>
</property>
<property>
<name>wrapper.logfile.rollmode</name>
<value>DATE</value>
</property>
<property>
<name>wrapper.logfile.maxfiles</name>
<value>10</value>
</property>
<property>
<name>wrapper.pidfile</name>
<value>/var/XXXX//${project.artifactId}</value>
</property>
<property>
<name>wrapper.java.command</name>
<value>/usr/local/jdk8/bin/java</value>
</property>
<property>
<name>wrapper.disable_restarts</name>
<value>TRUE</value>
</property>
<property>
<name>wrapper.jvm_exit.timeout</name>
<value>5</value>
</property>
<property>
<name>wrapper.shutdown.timeout</name>
<value>5</value>
</property>
<property>
<name>wrapper.cpu.timeout</name>
<value>0</value>
</property>
</configuration>
</generatorConfiguration>
</generatorConfigurations>
</daemon>
</daemons>
</configuration>
<executions>
<execution>
<id>generate-jsw</id>
<phase>package</phase>
<goals>
<goal>generate-daemons</goal>
</goals>
</execution>
</executions>
</plugin>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-assembly-plugin</artifactId>
<configuration>
<descriptors>
<descriptor>src/main/assembly/assembly.xml</descriptor>
</descriptors>
</configuration>
<executions>
<execution>
<id>make-assembly</id>
<phase>package</phase>
<goals>
<goal>single</goal>
</goals>
</execution>
</executions>
</plugin>
<plugin>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-maven-plugin</artifactId>
<version>${spring.boot.version}</version>
<executions>
<execution>
<goals>
<goal>build-info</goal>
</goals>
<configuration>
<additionalProperties>
<encoding.source>UTF-8</encoding.source>
<encoding.reporting>UTF-8</encoding.reporting>
<java.source>${java.version}</java.source>
<java.target>${java.version}</java.target>
</additionalProperties>
</configuration>
</execution>
</executions>
</plugin>
</plugins>
</build>
</profile>
tips：
1、不要太相信maven helper提示的jar沖突，具體還是要具體分析
2、有些jar沖突網(wǎng)上容易查到，有些基本查不到，可以先去tree搜個短名看看，看看有沒有相似的jar，再去查是否真的會有沖突
3、有些是class沖突，找到對應的jar排掉即可，盡量別排spring自帶的，容易出現(xiàn)兼容性問題
4、啟動時，我已經(jīng)將一些不必須的autoConfigure排掉了，真要用到，記得放出來，平時用不到的盡量排掉，這樣就不會去加載了，不然很多都是默認加載的。
以上為個人經(jīng)驗，希望能給大家一個參考，也希望大家多多支持腳本之家。
相關文章
這篇文章主要介紹了Spring ProtocolResolver策略接口示例,文中通過示例代碼介紹的非常詳細，對大家的學習或者工作具有一定的參考學習價值,需要的朋友可以參考下2020-04-04
SpringBoot在自定義類中調(diào)用service層mapper層方式
這篇文章主要介紹了SpringBoot在自定義類中調(diào)用service層mapper層方式,具有很好的參考價值,希望對大家有所幫助,如有錯誤或未考慮完全的地方,望不吝賜教2025-03-03
這篇文章主要介紹了如何在Java中獲取當天零點和明天零點的時間和時間戳,并提供了示例代碼,新手小白完全可以通過文中介紹的代碼實現(xiàn),需要的朋友可以參考下2025-03-03
Hibernate框架數(shù)據(jù)分頁技術實例分析
這篇文章主要介紹了Hibernate框架數(shù)據(jù)分頁技術,結(jié)合實例形式分析了Hibernate框架實現(xiàn)數(shù)據(jù)分頁的原理,步驟與相關實現(xiàn)技巧,需要的朋友可以參考下2016-03-03
本篇文章主要給大家詳細分享了搭建JavaWeb服務器的詳細步驟以及用到的代碼，對此有需要的朋友可以跟著學習下。2018-02-02
Mybatis+Druid+MybatisPlus多數(shù)據(jù)源配置方法
在項目開發(fā)中,經(jīng)常需要連接多個數(shù)據(jù)庫,使用Mybatis、Druid和MybatisPlus可以實現(xiàn)多數(shù)據(jù)源配置,通過定義配置類和修改配置文件,如properties或yaml,可以設置多個數(shù)據(jù)源,本文介紹了配置項包括Druid基本配置、數(shù)據(jù)源一、數(shù)據(jù)源二,感興趣的朋友一起看看吧2024-09-09
Java中HashSet和HashMap的區(qū)別_動力節(jié)點Java學院整理
這篇文章主要介紹了Java中HashSet和HashMap的區(qū)別_動力節(jié)點Java學院整理,需要的朋友可以參考下2017-04-04
Spring MVC 文件、cookies的接收 與REST響應詳
在SpringMVC中,使用@RequestPart注解可接收文件并處理多部分請求,同時可以通過@CookieValue和HttpServletResponse來獲取和設置Cookies,本文介紹Spring MVC 文件、cookies的接收 與REST響應,感興趣的朋友跟隨小編一起看看吧2024-09-09
詳解Mybatis-plus(MP)中CRUD操作保姆級筆記
本文主要介紹了Mybatis-plus(MP)中CRUD操作保姆級筆記，文中通過示例代碼介紹的非常詳細，具有一定的參考價值，感興趣的小伙伴們可以參考一下2021-11-11
Java如何實現(xiàn)讀取txt文件內(nèi)容并生成Word文檔
本文主要介紹了通過Java實現(xiàn)讀取txt文件中的內(nèi)容，并將內(nèi)容生成Word文檔。文章的代碼非常詳細，具有一定的學習價值，感興趣的小伙伴可以了解一下2021-12-12