Struts2於Tomcat 5.0啟動失誤：xml-apis.jar衝突解決方案

在Tomcat 5.0部署Struts2應用時，常遇到Error filterStart導致上下文啟動失敗，核心原因是XML解析器版本衝突。

錯誤現象

嚴重: Error filterStart
嚴重: Context startup failed due to previous errors

控制台無具體異常堆棧，需查看logs/catalina.out或logs/localhost.<日期>.log獲取詳細信息。

根本原因

Tomcat 5.0common/endorsed目錄包含xml-apis.jar（舊版JAXP API），與Struts2依賴的xercesImpl.jar（新版XML解析器）版本不兼容，導致javax.xml.parsers.DocumentBuilderFactory實例化失敗。

解決方案

1. 刪除衝突包（最簡直接）：

   
   # 進入Tomcat目錄
   cd $CATALINA_HOME/common/endorsed
   # 備份後刪除
   mv xml-apis.jar xml-apis.jar.bak
   

2. 升級Tomcat：Tomcat 5.5+已修正此問題，建議遷移至Tomcat 7/8/9
3. 隔離類加載：在context.xml配置<Loader delegate="false"/>優先加載Web應用庫

驗證修復

# 重啟Tomcat觀察日誌
./bin/startup.sh
tail -f logs/catalina.out
# 應見到:
信息: Initializing Struts2 filter
信息: Struts2 filter initialized successfully

深度排查技巧

• 啟用Tomcat詳細日誌：CATALINA_OPTS="-Djava.util.logging.config.file=logging.properties"
• 使用jconsole檢查類加載器層級
• 執行mvn dependency:tree排查傳遞依賴版本衝突

避坑指南

現代項目建議：使用Spring Boot內嵌容器、避免共享Tomcat部署、依賴管理交給Maven/Gradle鎖定版本。

1. 上一篇文章： 中西曆轉換算法Java實現：農曆節氣與干支計算
2. 下一篇文章： Java控制台輸入輸出完全指南：從System.in到BufferedReader

Java 相關知識

JCA 詳解：Java EE 中最低調卻關鍵的連接器架構規範

JCA 定位 Java EE Connector Archi

Spring + Eclipse 開發入門：IoC 容器與 AOP 實戰教學

開發環境準備 JDK 1.4.2+，配置 JAVA_H

WTP 1.0 開發 Web Service 實戰：從 Java Class 到 SOAP 服務

五分鐘打造溫度轉換 Web Service — Eclips

打造 Linux 開發環境全攻略：從三流娛樂到一流 Java 開發

記錄 Fedora 20 + Cinnamon 桌面環境下，