spring加載xsd的機制詳解(Failed to read schema document的解決辦法)

有時候你會發現過去一直啓動正常的系統,某天啓動時會報出形如下面的錯誤:

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文件讀取不到了,原因多是因爲斷網或spring的官網暫時無法連接導致的。 你可以通過在瀏覽器輸入xsd文件的URL,如:http://www.springframework.org/schema/beans/spring-beans-2.0.xsd 進行確認。

關於這個問題,網上有兩種常見的解決方法,第一種簡單有效,但是工作量大,即:把所有spring配置文件中url形式的xsd路徑轉換成指向本地xsd文件的classpath形式的路徑,例如:classpath:org/springframework/beans/factory/xml/spring-beans-2.5.xsd ,再有一種方法就是在本機搭建web服務器,按URL創建相應文件夾,放入對應xsd文件,在本機hosts文件中加入"127.0.0.1 www.springframework.org".實際上,這兩種方法都屬於“歪打正着”式的方法,直正弄明白這一問題還需要從spring的XSD文件加載機制談起。

首先:你必須知道一點:spring在加載xsd文件時總是先試圖在本地查找xsd文件(spring的jar包中已經包含了所有版本的xsd文件),如果沒有找到,纔會轉向去URL指定的路徑下載。這是非常合理的做法,並不像看上去的那樣,每次都是從站點下載的。事實上,假如你的所有配置是正確定的,你的工程完全可以在斷網的情況下啓動而不會報上面的錯誤。Spring加載xsd文件的類是PluggableSchemaResolver,你可以查看一下它的源碼來驗證上述說法。另外,你可以在log4j.xml文件中加入:

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


通過日誌瞭解spring是何加載xsd文件的。

接下來,問題就是爲什麼spring在本地沒有找到需要的文件,不得不轉向網站下載。關於這個問題,其實也非常簡單。在很多spring的jar包裏,在META-INF目錄下都有一個spring.schemas,這是一個property文件,其內容類似於下面:

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文件中加入了對應項,出現問題的情況往往是聲明使用了一個高版本的xsd文件,如3.0,但依賴的spring的jar包卻是2.5之前的版本,由於2.5版本自然不可能包含3.0的xsd文件,此時就會導致spring去站點下載目標xsd文件,如遇斷網或是目標站點不可用,上述問題就發生了。

但是,在實現開發中,出現上述錯誤的機率並不高,最常見的導致這一問題的原因其實與使用了一個名爲“assembly”的maven打包插件有關。很多項目需要將工程連同其所依賴的所有jar包打包成一個jar包,maven的assembly插件就是用來完成這個任務的。但是由於工程往往依賴很多的jar包,而被依賴的jar又會依賴其他的jar包,這樣,當工程中依賴到不同的版本的spring時,在使用assembly進行打包時,只能將某一個版本jar包下的spring.schemas文件放入最終打出的jar包裏,這就有可能遺漏了一些版本的xsd的本地映射,進而出現了文章開始提到的錯誤。如果你的項目是打成單一jar的,你可以通過檢查最終生成的jar裏的spring.schemas文件來確認是不是這種情況。而關於這種情況,解決的方法一般是推薦使用另外一種打包插件shade,它確實是一款比assembly更加優秀的工具,在對spring.schemas文件處理上,shade能夠將所有jar裏的spring.schemas文件進行合併,在最終生成的單一jar包裏,spring.schemas包含了所有出現過的版本的集合!


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


發佈了37 篇原創文章 · 獲贊 30 · 訪問量 20萬+
發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章