MyEclipse SSH 整合部署 Resin 3.0 避坑指南：XML 解析衝突與 Jar 包精簡

專案原在 Tomcat 6.0 運行良好，強制遷移至 Resin 3.0 後頻發 SAXNotRecognizedException，根因在於 Hibernate 帶入的舊版 XML 解析器（Xerces）與 Resin 內建解析器衝突。本文記錄排查全過程與精簡依賴的最佳實踐。

錯誤現場

ERROR Digester:686 - Digester.getParser:
org.xml.sax.SAXNotRecognizedException: https://apache.org/XML/features/validation/dynamic
    at com.caucho.xml.parsers.XmlSAXParserFactory.setFeature(XMLSAXParserFactory.java:94)
    at org.apache.commons.digester.parser.XercesParser.configureXerces(XercesParser.java:185)

單獨部署 Struts/Spring/Hibernate 皆正常，唯有加入 Hibernate 即報錯，鎖定為 Hibernate 依賴傳遞的包衝突。

排查與精簡步驟

1. 對比 Hibernate 專案加入前後的 WEB-INF/lib 變化。
2. 發現 Hibernate 3.x 引入 xercesImpl.jar、xml-apis.jar 等舊版 XML 解析包，Resin 3.0 已內建現代解析器，雙方特性標識不兼容。
3. 刪除衝突包：xercesImpl.jar、xml-apis.jar、dom4j.jar（若 Resin 已提供）等。
4. 保留核心依賴：hibernate3.jar、antlr-2.7.5H3.jar（Hibernate 3 必需）。
5. 重新部署，錯誤消失，應用正常啟動。

Hibernate 3 必需與冗餘 Jar 參考表

經驗總結

• 依賴傳遞是雙刃劍：Maven/Ivy 未普及時，手工管理 Jar 更需警惕傳遞性依賴帶來的版本衝突。
• 容器優先原則：Servlet 容器/J2EE 伺服器已提供的 API（JAXP、JTA、JNDI 等）應優先使用容器版本，避免應用層重複引入。
• 最小依賴集測試：新增框架時，先構建最小可運行依賴集，再逐項加入業務所需庫，快速定位衝突源。

遷移容器本質是運行時環境變更，依賴衝突在所難免。建立「精簡依賴、容器優先」的部署習慣，能將此類問題消滅在萌芽狀態。