Spring ContextLoaderListener 啟動失敗排查指南

現象

在 web.xml 配置 org.springframework.web.context.ContextLoaderListener 後，Tomcat 啟動報錯：
Artifact mymaven:war exploded: Error during artifact deployment. See server log for details.
但日志中無明顯異常信息。註釋掉該監聽器則正常運行。

常見原因與排查步驟

1. Spring 配置文件路徑錯誤：contextConfigLocation 未指定或路徑寫錯，導致找不到 applicationContext.xml。
2. 依賴包衝突/缺失：spring-web、spring-context 版本不一致，或缺少 commons-logging 等傳遞依賴。
3. 類加載器問題：Eclipse/IDEA 發布配置錯誤，導致 WEB-INF/lib 下 JAR 未隨 WAR 部署。
4. 配置文件語法錯誤：XML 命名空間、Schema 版本不匹配，或 Bean 定義錯誤（如循環依賴、類不存在）。

建議排查動作

• 啟用 Tomcat 詳細日志（logging.properties 設置 FINE 級別）。
• 檢查 web.xml 是否配置 contextConfigLocation：
  <context-param><param-name>contextConfigLocation</param-name><param-value>classpath:applicationContext.xml</param-value></context-param>
• 使用 mvn dependency:tree 檢查 Spring 依賴版本統一。
• 在 IDE 中確認「Deployment Assembly」包含 Maven Dependencies。

總結

ContextLoaderListener 啟動失敗多由配置路徑、依賴衝突或發布配置引起。建議從日志級別、配置文件、依賴樹、發布路徑四個維度系統排查。