快捷導(dǎo)航

tomcat加載jar異常問題的分析與解決

更新時間：2019年04月07日 10:47:36 作者：山東大蔥哥

這篇文章主要給大家介紹了關(guān)于tomcat加載jar異常問題的分析與解決方法，文中通過示例代碼介紹的非常詳細(xì)，對大家學(xué)習(xí)或者使用tomcat具有一定的參考學(xué)習(xí)價值，需要的朋友們下面來一起學(xué)習(xí)學(xué)習(xí)吧

現(xiàn)象描述：

項目使用springboot啟動一個web項目，在啟動階段看到console中出現(xiàn)了異常“1.10.3-1.4.3\hdf5.jar 系統(tǒng)找不到指定的文件”，雖然這些異常不影響項目的正常運(yùn)行，但作為一個嚴(yán)謹(jǐn)?shù)募夹g(shù)人員，看到這些異常就像見到仇人一樣，一定要除之而后快。

java.io.FileNotFoundException: D:\.m2\repository\org\bytedeco\javacpp-presets\hdf5-platform\1.10.3-1.4.3\hdf5.jar (系統(tǒng)找不到指定的文件。)
 at java.util.zip.ZipFile.open(Native Method)
 at java.util.zip.ZipFile.<init>(ZipFile.java:225)
 at java.util.zip.ZipFile.<init>(ZipFile.java:155)
 at java.util.jar.JarFile.<init>(JarFile.java:166)
 at java.util.jar.JarFile.<init>(JarFile.java:130)
 at org.apache.tomcat.util.compat.JreCompat.jarFileNewInstance(JreCompat.java:188)
 at org.apache.tomcat.util.scan.JarFileUrlJar.<init>(JarFileUrlJar.java:65)
 at org.apache.tomcat.util.scan.JarFactory.newInstance(JarFactory.java:49)
 at org.apache.tomcat.util.scan.StandardJarScanner.process(StandardJarScanner.java:374)
 at org.apache.tomcat.util.scan.StandardJarScanner.processURLs(StandardJarScanner.java:309)
 at org.apache.tomcat.util.scan.StandardJarScanner.doScanClassPath(StandardJarScanner.java:266)
 at org.apache.tomcat.util.scan.StandardJarScanner.scan(StandardJarScanner.java:229)
 at org.apache.jasper.servlet.TldScanner.scanJars(TldScanner.java:262)
 at org.apache.jasper.servlet.TldScanner.scan(TldScanner.java:104)
 at org.apache.jasper.servlet.JasperInitializer.onStartup(JasperInitializer.java:101)
 at org.apache.catalina.core.StandardContext.startInternal(StandardContext.java:5204)
 at org.apache.catalina.util.LifecycleBase.start(LifecycleBase.java:150)
 at org.apache.catalina.core.ContainerBase$StartChild.call(ContainerBase.java:1421)
 at org.apache.catalina.core.ContainerBase$StartChild.call(ContainerBase.java:1411)
 at java.util.concurrent.FutureTask.run$$$capture(FutureTask.java:266)
 at java.util.concurrent.FutureTask.run(FutureTask.java)
 at java.util.concurrent.ThreadPoolExecutor.runWorker(ThreadPoolExecutor.java:1149)
 at java.util.concurrent.ThreadPoolExecutor$Worker.run(ThreadPoolExecutor.java:624)
 at java.lang.Thread.run(Thread.java:748)

2019-03-29 18:09:08.303 WARN 16940 --- [ost-startStop-1] o.a.tomcat.util.scan.StandardJarScanner : Failed to scan [file:/D:/.m2/repository/org/bytedeco/javacpp-presets/hdf5-platform/1.10.3-1.4.3/hdf5-linux-x86.jar] from classloader hierarchy

java.io.FileNotFoundException: D:\.m2\repository\org\bytedeco\javacpp-presets\hdf5-platform\1.10.3-1.4.3\hdf5-linux-x86.jar (系統(tǒng)找不到指定的文件。)
......
2019-03-29 18:09:08.578 WARN 16940 --- [ost-startStop-1] o.a.tomcat.util.scan.StandardJarScanner : Failed to scan [file:/D:/.m2/repository/org/bytedeco/javacpp-presets/hdf5-platform/1.10.3-1.4.3/hdf5-linux-x86_64.jar] from classloader hierarchy

java.io.FileNotFoundException: D:\.m2\repository\org\bytedeco\javacpp-presets\hdf5-platform\1.10.3-1.4.3\hdf5-linux-x86_64.jar (系統(tǒng)找不到指定的文件。)

項目環(huán)境說明

tomcat：使用springboot內(nèi)置版本 8.5.29
使用Maven進(jìn)行依賴管理
spring boot 版本為2.0.1
spring 框架版本為5.0.5
項目引用了Deep Learn 4 Java（一個非常棒的Java的機(jī)器學(xué)習(xí)庫）

 <dependency>
 <groupId>org.deeplearning4j</groupId>
 <artifactId>deeplearning4j-core</artifactId>
 <version>1.0.0-beta3</version>
 </dependency>

有問題的jar依賴關(guān)系

跟蹤分析

既然是在啟動階段報錯，那就找到啟動類添加斷點，一步步跟蹤下到底哪個階段報的錯誤，然后再分析出錯的原因。我跟蹤調(diào)試了springboot的代碼，找到j(luò)ar的加載位置。主要的幾個類和方法如下所示：

跟蹤類org.apache.tomcat.util.scan.StandardJarScanner

方法doScanClassPath(...)

該方法會對所有classloader進(jìn)行遍歷，加載每一個classloader中jar包

上圖標(biāo)紅處就是關(guān)鍵代碼，其中變量classPathUrlsToProcess中存放的是所有待加載的jar信息，主要是jar包路徑信息，我們可以看到這里面和我們在maven中看到的jar包是一樣的。

方法processURLs(...)

該方法會對當(dāng)前classloader的所有jar，也就是對classPathUrlsToProcess進(jìn)行堆棧操作，然后處理每一個jar包。關(guān)鍵代碼如下所示。

方法process()

該方法會對每一個jar進(jìn)行加載及分析處理，該方法中重點關(guān)注

processManifest(jar, isWebapp, classPathUrlsToProcess)

方法 processManifest

該方法會處理jar中的Manifest文件，對Manifest文件中的Class-Path進(jìn)行分隔處理，對其中的內(nèi)容作為新的依賴jar再插入到classPathUrlsToProcess中（processURLs方法會按照堆棧結(jié)果加載其中的jar）

原因分析

其實問題就是出Manifest文件中的classpath，通過分析代碼我們知道tomcat除了加載了我們maven管理的jar包之外，還會對jar中的manifest文件進(jìn)行分析，如果其中存在classpath，他會將其中的內(nèi)容也添加jar包依賴中，并對這些jar包進(jìn)行加載。

我們打開其中hdf5-1.10.3-1.4.3.jar的manifest文件作為例子看看錯誤出在哪里。

大家注意到了沒有，這里的jar包沒有路徑也沒有版本號，這就導(dǎo)致tomcat加載的時候按照hdf5-1.10.3-1.4.3.jar的路徑進(jìn)行加載。

然而我們的工程中在對應(yīng)位置并不存在這些jar，這也就導(dǎo)致了找不到j(luò)ar的異常。我們工程中實際上有這些jar，只不過路徑和名字不一樣。在上圖左邊大家可以看到maven中其實已經(jīng)有了這些jar，只不過名字后面多了版本號，路徑在各自的maven倉庫中。

到這里我們已經(jīng)將出現(xiàn)問題的原因弄清楚了，接下來我們考慮下怎么解決。

解決方案

方案一：

刪除Manifest中的classpath或者刪除Manifest文件，這樣就避免了加載不存在的jar包。但是每次maven更新的時候可能會覆蓋掉你的修改，導(dǎo)致異常再次出現(xiàn)。

方案二：

按照加載提示的路徑，將對應(yīng)jar包復(fù)制過去并改名去掉版本號，但這樣會造成jar冗余，同樣的jar會加載兩個。

方案三：

降級tomcat版本，使用8.5.0 或以下版本。8.5.0版本中不會對manifest進(jìn)行分析加載，這樣也就不會出現(xiàn)我們的異常了。

方案四

增加一下代碼設(shè)置不掃描Manifest文件。

 @Bean
 public TomcatServletWebServerFactory tomcatFactory() {
  return new TomcatServletWebServerFactory() {
   @Override
   protected void postProcessContext(Context context) {
    ((StandardJarScanner) context.getJarScanner()).setScanManifest(false);
   }
  };
 }