Spring ContextLoaderListener 配置缺失導致啟動失敗：Maven 依賴修復指南

錯誤現象

嚴重: 配置類 org.springframework.web.context.ContextLoaderListener 初始化失敗
java.lang.ClassNotFoundException: org.springframework.web.context.ContextLoaderListener

典型原因：web.xml 宣告了 ContextLoaderListener，但專案缺少 spring-web 模組依賴，或 Maven 依賴解析異常導致 JAR 未納入 WEB-INF/lib。

web.xml 典型配置

<context-param>
    <param-name>contextConfigLocation</param-name>
    <param-value>classpath:applicationContext.xml</param-value>
</context-param>

<listener>
    <listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>
</listener>

Maven 依賴修復

<dependency>
    <groupId>org.springframework</groupId>
    <artifactId>spring-web</artifactId>
    <version>5.3.30</version> <!-- 或統一由 Spring BOM 管理版本 -->
</dependency>

關鍵點：ContextLoaderListener 位於 spring-web 模組，而非 spring-context。

Eclipse/Maven 專案同步檢查清單

1. Maven → Update Project：右鍵專案 → Maven → Update Project → ☑ Force Update
2. Deployment Assembly：Properties → Deployment Assembly → 確認 Maven Dependencies 已映射至 WEB-INF/lib
3. 伺服器發布：Servers 視圖 → 右鍵伺服器 → Clean → Clean Tomcat Work Directory → Republish
4. 本地倉庫完整性：刪除 ~/.m2/repository/org/springframework/spring-web/ 重新下載

Spring 版本對應表

進階：手動添加 JAR 到構建路徑 (不推薦，應修復 Maven)

若臨時需驗證：

1. 從 ~/.m2/repository/org/springframework/spring-web/5.3.30/spring-web-5.3.30.jar 複製
2. 貼至 WebContent/WEB-INF/lib/
3. 右鍵專案 → Build Path → Configure Build Path → Add JARs → 選擇該 JAR

警告：此方式繞過 Maven 管理，升級/遞移依賴易失效，僅供臨時排查。

1. 上一篇文章： Java 內部類完全指南：成員內部類、局部內部類、匿名內部類與最佳實踐
2. 下一篇文章： SVNKit 入門指南：純 Java 操作 Subversion 的高層與低層 API 完整解析

Java 綜合教學

Struts2 基礎筆記圖解：青軟 S2SH 整合學習資料

Struts2 基礎筆記圖解：青軟 S2SH 整合學習資料

JVM 核心知識體系（三）：Java 內存模型（JMM）完整總結與 volatile 實戰

JVM 核心知識體系（三）：Java 內存模型（JMM）完整

應用系統日誌採集解決方案：Flume + MongoDB + WebService 架構設計

應用系統日誌採集解決方案：Flume + MongoDB +

CentOS 6.5 單機部署 Tomcat7+Nginx+Redis 實現負載均衡與 Session 共享

架構拓撲與版本鎖定 本文演示單機多實例部署，拓撲如下： T