有時候你會發(fā)現(xiàn)過去一直啟動正常的系統(tǒng)，某天啟動時會報出形如下面的錯誤：

org.xml.sax.SAXParseException: schema_reference.4: Failed to read schema document 'http://www.springframework.org/schema/beans/spring-beans-2.0.xsd', because 1) could not find the document; 2) the document could not be read; 3) the root element of the document is not <xsd:schema>.

很顯然，spring xml配置文件中指定的xsd文件讀取不到了，原因多是因為斷網(wǎng)或spring的官網(wǎng)暫時無法連接導致的。 你可以通過在瀏覽器輸入xsd文件的URL，如：http://www.springframework.org/schema/beans/spring-beans-2.0.xsd 進行確認。

關于這個問題，網(wǎng)上有兩種常見的解決方法，第一種簡單有效，但是工作量大，即：把所有spring配置文件中url形式的xsd路徑轉(zhuǎn)換成指向本地xsd文件的classpath形式的路徑

例如：classpath:org/springframework/beans/factory/xml/spring-beans-2.5.xsd ,再有一種方法就是在本機搭建web服務器，按URL創(chuàng)建相應文件夾，放入對應xsd文件，在本機hosts文件中加入"127.0.0.1 www.springframework.org".實際上，這兩種方法都屬于“歪打正著”式的方法，直正弄明白這一問題還需要從spring的XSD文件加載機制談起。

首先：你必須知道一點：spring在加載xsd文件時總是先試圖在本地查找xsd文件(spring的jar包中已經(jīng)包含了所有版本的xsd文件)，如果沒有找到，才會轉(zhuǎn)向去URL指定的路徑下載。

這是非常合理的做法，并不像看上去的那樣，每次都是從站點下載的。事實上，假如你的所有配置是正確定的，你的工程完全可以在斷網(wǎng)的情況下啟動而不會報上面的錯誤。Spring加載xsd文件的類是PluggableSchemaResolver，你可以查看一下它的源碼來驗證上述說法。另外，你可以在log4j.xml文件中加入：

	<logger name="org.springframework.beans.factory.xml">
		<level value="all" />
	</logger>

通過日志了解spring是何加載xsd文件的。

接下來，問題就是為什么spring在本地沒有找到需要的文件，不得不轉(zhuǎn)向網(wǎng)站下載。關于這個問題，其實也非常簡單。在很多spring的jar包里，在META-INF目錄下都有一個spring.schemas，這是一個property文件，其內(nèi)容類似于下面：

http\://www.springframework.org/schema/beans/spring-beans-2.0.xsd=org/springframework/beans/factory/xml/spring-beans-2.0.xsd
http\://www.springframework.org/schema/beans/spring-beans-2.5.xsd=org/springframework/beans/factory/xml/spring-beans-2.5.xsd
http\://www.springframework.org/schema/beans/spring-beans-3.0.xsd=org/springframework/beans/factory/xml/spring-beans-3.0.xsd
....

實際上，這個文件就是spring關于xsd文件在本地存放路徑的映射，spring就是通過這個文件在本地（也就是spring的jar里）查找xsd文件的。那么，查找不到的原因排除URL輸入有誤之外，可能就是聲明的xsd文件版本在本地不存在。

一般來說，新版本的spring jar包會將過去所有版本(應該是自2.0以后)的xsd打包，并在spring.schemas文件中加入了對應項，出現(xiàn)問題的情況往往是聲明使用了一個高版本的xsd文件，如3.0，但依賴的spring的jar包卻是2.5之前的版本，由于2.5版本自然不可能包含3.0的xsd文件，此時就會導致spring去站點下載目標xsd文件，如遇斷網(wǎng)或是目標站點不可用，上述問題就發(fā)生了。

但是，在實現(xiàn)開發(fā)中，出現(xiàn)上述錯誤的幾率并不高，最常見的導致這一問題的原因其實與使用了一個名為“assembly”的maven打包插件有關。很多項目需要將工程連同其所依賴的所有jar包打包成一個jar包，maven的assembly插件就是用來完成這個任務的。

但是由于工程往往依賴很多的jar包，而被依賴的jar又會依賴其他的jar包，這樣，當工程中依賴到不同的版本的spring時，在使用assembly進行打包時，只能將某一個版本jar包下的spring.schemas文件放入最終打出的jar包里，這就有可能遺漏了一些版本的xsd的本地映射，進而出現(xiàn)了文章開始提到的錯誤。

如果你的項目是打成單一jar的，你可以通過檢查最終生成的jar里的spring.schemas文件來確認是不是這種情況。而關于這種情況，解決的方法一般是推薦使用另外一種打包插件shade,它確實是一款比assembly更加優(yōu)秀的工具，在對spring.schemas文件處理上，shade能夠?qū)⑺衘ar里的spring.schemas文件進行合并，在最終生成的單一jar包里，spring.schemas包含了所有出現(xiàn)過的版本的集合！

以上就是spring加載XSD文件的機制和出現(xiàn)問題的原因分析。實際上，我們應該讓我們工程在啟動時總是加載本地的xsd文件，而不是每次去站點下載，做到這一點就需要你結(jié)合上述提及的種種情況對你的工程進行一番檢查。

以上就是本文的全部內(nèi)容，希望對大家的學習有所幫助，也希望大家多多支持腳本之家。

最新評論