一个XML解析失败排查过程的分享

这篇文章虽然没有解决我的问题，但是解析过程非常精彩，值得学习

原文地址：http://www.4ucode.com/Study/Topic/2073303

今天遇到一个比较诡异的问题, 我们的应用在JBoss下可以正常部署, 到Jetty环境下则部署失败,并提示如下信息:

2011-06-14 18:14:34.812:WARN::Failed startup of context runjettyrun.HSFJettyWebAppContext@1f21c50{/,src/main/webapp}org.springframework.beans.factory.xml.XmlBeanDefinitionStoreException: Line 37 in XML document from ServletContext resource [/WEB-INF/webx.xml] is invalid; nested exception is org.xml.sax.SAXParseException: cvc-complex-type.2.4.c: The matching wildcard is strict, but no declaration can be found for element 'services:webx-configuration'.    at org.springframework.beans.factory.xml.XmlBeanDefinitionReader.doLoadBeanDefinitions(XmlBeanDefinitionReader.java:404)    <中间略去若干行>2011-06-14 18:14:34.814:WARN::Nested in org.springframework.beans.factory.xml.XmlBeanDefinitionStoreException: Line 37 in XML document from ServletContext resource [/WEB-INF/webx.xml] is invalid; nested exception is org.xml.sax.SAXParseException: cvc-complex-type.2.4.c: The matching wildcard is strict, but no declaration can be found for element 'services:webx-configuration'.:org.xml.sax.SAXParseException: cvc-complex-type.2.4.c: The matching wildcard is strict, but no declaration can be found for element 'services:webx-configuration'.    at org.apache.xerces.parsers.DOMParser.parse(Unknown Source)    at org.apache.xerces.jaxp.DocumentBuilderImpl.parse(Unknown Source)    at org.springframework.beans.factory.xml.DefaultDocumentLoader.loadDocument(DefaultDocumentLoader.java:75)    at org.springframework.beans.factory.xml.XmlBeanDefinitionReader.doLoadBeanDefinitions(XmlBeanDefinitionReader.java:396)    <中间略去若干行>2011-06-14 18:14:34.829:INFO::Started SelectChannelConnector@0.0.0.0:80
 




上面花了大篇幅粘贴错误日志，只是想留个纪念。
 
出现这个问题，首先怀疑到的是环境是不是有问题。检查了一会儿，没有头绪。换个思路看看，瞅瞅这两天有哪些文件变更。（小注：之前一直运行正常）。通过观察SVN日志，发现最近有新引入了一个包（且记为A.jar）。或许这就是问题所在。
 
我们的工程是用Maven进行依赖管理的，所以接着我在POM中将新引入的A.jar移除，再次部署应用，果然正常启动。但是A.jar可能别的同事在用，不能草率的移除了事。并且我断定不是A.jar本身，而是其带来的间接依赖导致上述的问题。
 
紧接着我需要做的是揪出A带来的间接依赖中的哪一个导致XML解析失败。
 
首先我打印出了增加A.jar和移除A.jar后的依赖树，命令如下：
mvn dependency:tree > with_a
mvn dependency:tree > without_a
 
然后用BeyondCompare比对with_a和without_a两个文件的差异内容，因为A的依赖关系很复杂，所以单纯肉眼，分辨不出哪个依赖出了问题，只好放弃了这条路子。
 
后面又仔细阅读了一遍错误日志，然后缩小搜索范围，因为从字面上看，不外乎与XML和Spring相关。于是排查了Spring版本是否正常，并确定和Spring无关。那只能是XML相关的依赖导致问题了。
 
再次查看工程依赖树，和XML解析相关的包大致有：xml-apis、xml-resolver、xmlParserAPIs、xercesImpl等。这回还真有所收获，发现因为A的引入，导致了xercesImpl的版本降级。在引入A之前的xercesImpl版本为2.9.1、引入A后则变为2.4.0. 赶紧排除A中的xercesImpl，部署应用，正常启动，搞定收工。
 
这也解释了为什么Jboss可以正常部署，因为Jboss自带了xercesImpl-2.7.1.
 
By Mr.Chris