Spring如何加載XSD文件(org.xml.sax.SAXParseException: Failed to read schema document錯誤的解決方法)


今天配置Spring的xml出現了錯誤

Multiple annotations found at this line:
    - schema_reference.4: Failed to read schema document 'http://www.springframework.org/schema/context/spring-context-4.2.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>.
    - cvc-complex-type.2.4.c: The matching wildcard is strict, but no declaration can be found for element 'context:property-placeholder'.

很顯然,spring xml配置文件中指定的xsd文件讀取不到了,原因多是因為斷網或spring的官網暫時無法連接導致的。 你可以通過在瀏覽器輸入xsd文件的URL,如:

http://www.springframework.org/schema/context/spring-context-4.2.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文件,而不是每次去站點下載,做到這一點就需要你結合上述提及的種種情況對你的工程進行一番檢查。

 

這樣的類似的報錯,解決方法都應該相同。

首先推薦看一篇csdn上關於spring載入xsd命名空間的文章:http://blog.csdn.net/bluishglc/article/details/7596118

我這里簡單總結一下解決這類問題的方法:

1.報這類錯誤經常的原因是沒有導入對應的jar包。如果你不確定,可以找下相關的jar包中是否有對應的xsd文件。

2.如果上面確認有xsd文件,確定你spring xmlns引入的版本在jar包中有。否則更正版本。

經過上面兩步正常應該已經可以解決,原因,以及一些小技巧,可以參考上面的文章。

下面是我在eclipse Mars.2下遇到的另類問題

上面的步驟都正確,但是還是報錯,我先把解決方法說了,后面說我猜想的原因。~_~真實原因,不明白呀!求指點

我的解決方法,就是在xml catelog添加對應的條目

(這里我臨時測試時候把xsd文件放桌面了,后來刪除了,所以有紅叉號)

添加以后,問題就解決了。

同樣的部署,在Myeclipse下面是能正常運行的,但是在Eclipse下就會出現問題,所以我猜測問題的原因是,兩周ide的校驗搜索模式不同,所以造成的問題。

這只是一種猜測,希望對你有幫助。現在我的是沒有問題了。。。繼續


免責聲明!

本站轉載的文章為個人學習借鑒使用,本站對版權不負任何法律責任。如果侵犯了您的隱私權益,請聯系本站郵箱yoyou2525@163.com刪除。



 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM