摘要：的打包結(jié)構(gòu)改動是這個引入的這個的本意是簡化的繼承關(guān)系，以一種直觀的優(yōu)先的方式來實現(xiàn)，同時打包結(jié)構(gòu)和傳統(tǒng)的包應(yīng)用更接近。目前的繼承關(guān)系帶來的一些影響有很多用戶可能會發(fā)現(xiàn)，一些代碼在里跑得很好，但是在實際部署運行時不工作。

對spring boot本身啟動原理的分析，請參考：http://hengyunabc.github.io/s...

可以運行下面提供的demo，分別在不同的場景下運行，可以知道不同場景下的Spring boot應(yīng)用的ClassLoader繼承關(guān)系。

https://github.com/hengyunabc...

分三種情況：

則Spring的ClassLoader直接是SystemClassLoader。ClassLoader的urls包含全部的jar和自己的target/classes

========= Spring Boot Application ClassLoader Urls =============

ClassLoader urls: sun.misc.Launcher$AppClassLoader@2a139a55

file:/Users/hengyunabc/code/java/spring-boot-inside/demo-classloader-context/target/classes/

file:/Users/hengyunabc/.m2/repository/org/springframework/cloud/spring-cloud-starter/1.1.9.RELEASE/spring-cloud-starter-1.1.9.RELEASE.jar

file:/Users/hengyunabc/.m2/repository/org/springframework/boot/spring-boot-starter/1.4.7.RELEASE/spring-boot-starter-1.4.7.RELEASE.jar

...

mvn clean package

java -jar target/demo-classloader-context-0.0.1-SNAPSHOT.jar

執(zhí)行應(yīng)用的main函數(shù)的ClassLoader是LaunchedURLClassLoader，它的parent是SystemClassLoader。

========= ClassLoader Tree=============

org.springframework.boot.loader.LaunchedURLClassLoader@1218025c

- sun.misc.Launcher$AppClassLoader@6bc7c054

-- sun.misc.Launcher$ExtClassLoader@85ede7b

并且LaunchedURLClassLoader的urls是 fat jar里的BOOT-INF/classes!/目錄和BOOT-INF/lib里的所有jar。

========= Spring Boot Application ClassLoader Urls =============

ClassLoader urls: org.springframework.boot.loader.LaunchedURLClassLoader@1218025c

jar:file:/Users/hengyunabc/code/java/spring-boot-inside/demo-classloader-context/target/demo-classloader-context-0.0.1-SNAPSHOT.jar!/BOOT-INF/classes!/

jar:file:/Users/hengyunabc/code/java/spring-boot-inside/demo-classloader-context/target/demo-classloader-context-0.0.1-SNAPSHOT.jar!/BOOT-INF/lib/spring-boot-1.4.7.RELEASE.jar!/

jar:file:/Users/hengyunabc/code/java/spring-boot-inside/demo-classloader-context/target/demo-classloader-context-0.0.1-SNAPSHOT.jar!/BOOT-INF/lib/spring-web-4.3.9.RELEASE.jar!/

...

SystemClassLoader的urls是demo-classloader-context-0.0.1-SNAPSHOT.jar本身。

========= System ClassLoader Urls =============

ClassLoader urls: sun.misc.Launcher$AppClassLoader@6bc7c054

file:/Users/hengyunabc/code/java/spring-boot-inside/demo-classloader-context/target/demo-classloader-context-0.0.1-SNAPSHOT.jar

mvn clean package

cd target

unzip demo-classloader-context-0.0.1-SNAPSHOT.jar -d demo

cd demo

java org.springframework.boot.loader.PropertiesLauncher

執(zhí)行應(yīng)用的main函數(shù)的ClassLoader是LaunchedURLClassLoader，它的parent是SystemClassLoader。

========= ClassLoader Tree=============

org.springframework.boot.loader.LaunchedURLClassLoader@4aa298b7

- sun.misc.Launcher$AppClassLoader@2a139a55

-- sun.misc.Launcher$ExtClassLoader@1b6d3586

LaunchedURLClassLoader的urls是解壓目錄里的BOOT-INF/classes/和/BOOT-INF/lib/下面的jar包。

========= Spring Boot Application ClassLoader Urls =============

ClassLoader urls: org.springframework.boot.loader.LaunchedURLClassLoader@4aa298b7

file:/Users/hengyunabc/code/java/spring-boot-inside/demo-classloader-context/target/demo/BOOT-INF/classes/

jar:file:/Users/hengyunabc/code/java/spring-boot-inside/demo-classloader-context/target/demo/BOOT-INF/lib/bcpkix-jdk15on-1.55.jar!/

jar:file:/Users/hengyunabc/code/java/spring-boot-inside/demo-classloader-context/target/demo/BOOT-INF/lib/bcprov-jdk15on-1.55.jar!/

jar:file:/Users/hengyunabc/code/java/spring-boot-inside/demo-classloader-context/target/demo/BOOT-INF/lib/classmate-1.3.3.jar!/

SystemClassLoader的urls只有當前目錄：

========= System ClassLoader Urls =============

ClassLoader urls: sun.misc.Launcher$AppClassLoader@2a139a55

file:/Users/hengyunabc/code/java/spring-boot-inside/demo-classloader-context/target/demo/

其實還有兩種運行方式：mvn spring-boot:run 和 mvn spring-boot:run -Dfork=true，但是比較少使用，不多帶帶討論。感覺興趣的話可以自行跑下。

在IDE里main函數(shù)執(zhí)行時，只有一個ClassLoader，也就是SystemClassLoader

在以fat jar運行時，有一個LaunchedURLClassLoader，它的parent是SystemClassLoader

LaunchedURLClassLoader的urls是fat jar里的BOOT-INF/classes和BOOT-INF/lib下的jar。SystemClassLoader的urls是fat jar本身。

在解壓目錄（exploded directory）運行時，和fat jar類似，不過url都是目錄形式。目錄形式會有更好的兼容性。

在spring boot 1.3.* 版本里

應(yīng)用的類和spring boot loader的類都是打包在一個fat jar里

應(yīng)用依賴的jar放在fat jar里的/lib下面。

在spring boot 1.4.* 版本后

spring boot loader的類放在fat jar里

應(yīng)用的類打包放在fat jar的BOOT-INF/classes目錄里

應(yīng)用依賴的jar放在fat jar里的/lib下面。

spring boot 1.4的打包結(jié)構(gòu)改動是這個commit引入的

https://github.com/spring-pro...

這個commit的本意是簡化classloader的繼承關(guān)系，以一種直觀的parent優(yōu)先的方式來實現(xiàn)LaunchedURLClassLoader，同時打包結(jié)構(gòu)和傳統(tǒng)的war包應(yīng)用更接近。

但是這個改動引起了很多復雜的問題，從上面我們分析的ClassLoader繼承關(guān)系就有點頭暈了。

有很多用戶可能會發(fā)現(xiàn)，一些代碼在IDE里跑得很好，但是在實際部署運行時不工作。很多時候就是ClassLoader的結(jié)構(gòu)引起的，下面分析一些案例。

因為spring boot是擴展了標準的jar協(xié)議，讓它支持多層的jar in jar，還有directory in jar。參考spring boot應(yīng)用啟動原理分析

在spring boot 1.3的時候盡管會有jar in jar，但是一些比較健壯的代碼可以處理這種情況，比如tomcat8自己就支持jar in jar。

但是絕大部分代碼都不會支持像demo.jar!/BOOT-INF/classes!/ 這樣子directory in jar的多重url，所以在spring boot1.4里，很多庫的代碼都會失效。

在servlet 3.0規(guī)范里，應(yīng)用可以把靜態(tài)資源放在META-INF/resources下面，servlet container會支持讀取。但是從上面的繼承結(jié)果，我們可以發(fā)現(xiàn)一個問題：

應(yīng)用以fat jar來啟動，啟動embedded tomcat的ClassLoader是LaunchedURLClassLoader

LaunchedURLClassLoader的urls并沒有fat jar本身

應(yīng)用的main函數(shù)所在的模塊的src/main/resources/META-INF/resources目錄被打包到了fat jar里，也就是demo.jar!/META-INF/resources

應(yīng)用的fat jar是SystemClassLoader的url，也就是LaunchedURLClassLoader的parent

這樣子就造成了一些奇怪的現(xiàn)象：

應(yīng)用直接用自己的ClassLoader.getResources()是可以獲取到META-INF/resources的資源的

但是embedded tomcat并沒有把fat jar本身加入到它的 ResourcesSet 里，因為它在啟動時ClassLoader是LaunchedURLClassLoader，它只掃描自己的ClassLoader的urls

應(yīng)用把資源放在其它的jar包的META-INF/resources下可以訪問到，把資源放在自己的main函數(shù)的src/main/resources/META-INF/resources下時，訪問不到了

另外，spring boot的官方j(luò)sp的例子只支持war的打包格式，不支持fat jar，也是由這個引起的。

getResource("")的語義是返回ClassLoader的urls的第一個url，很多時候使用者以為這個就是它們自己的classes的目錄，或者是jar的url。

但是實際上，因為ClassLoader加載urls列表時，有隨機性，和OS低層實現(xiàn)有關(guān)，并不能保證urls的順序都是一樣的。所以getResource("")很多時候返回的結(jié)果并不一樣。

但是很多庫，或者應(yīng)用依賴這個代碼來定位掃描資源，這樣子在spring boot下就不工作了。

另外，值得注意的是spring boot在三種不同形式下運行，getResources("")返回的結(jié)果也不一樣。用戶可以自己改下demo里的代碼，打印下結(jié)果。

簡而言之，不要依賴這兩個API，最好自己放一個資源來定位?；蛘咧苯永胹pring自身提供的資源掃描機制。

用戶有多個代碼模塊，在不同模塊下都放了多個*-service.xml的spring配置文件。

用戶如果使用類似classpath*:**-service.xml的通配符來加載資源的話，很有可能出現(xiàn)在IDE里跑時，可以正確加載，但是在fat jar下，卻加載不到的問題。

從spring自己的文檔可以看到相關(guān)的解析：

https://docs.spring.io/spring...

WARNING: Note that "classpath:" when combined with Ant-style patterns will only work reliably with at least one root directory before the pattern starts, unless the actual target files reside in the file system. This means that a pattern like "classpath:*.xml" will not retrieve files from the root of jar files but rather only from the root of expanded directories. This originates from a limitation in the JDK"s ClassLoader.getResources() method which only returns file system locations for a passed-in empty String (indicating potential roots to search). This ResourcePatternResolver implementation is trying to mitigate the jar root lookup limitation through URLClassLoader introspection and "java.class.path" manifest evaluation; however, without portability guarantees.

就是說使用 classpath*來匹配其它的jar包時，需要有一層目錄在前面，不然的話是匹配不到的，這個是ClassLoader.getResources() 函數(shù)導致的。

因為在IDE里跑時，應(yīng)用所依賴的其它模塊通常就是一個classes目錄，所以通常沒有問題。

但是當以fat jar來跑時，其它的模塊都被打包為一個jar，放在BOOT-INF/lib下面，所以這時通配就會失敗。

這個新的BOOT-INF打包格式有它的明顯好處：更清晰，更接近war包的格式。

spring boot的ClassLoader的結(jié)構(gòu)修改帶來的復雜問題，并非當初修改的人所能預(yù)見的

很多問題需要理解spring boot的ClassLoader結(jié)構(gòu)，否則不能找到根本原因

橫云斷嶺的專欄