Java Web 常見錯誤排查：404 請求資源不可用與 Spring 監聽器類找不到異常解決

Java Web 常見錯誤排查：404 請求資源不可用與 Spring 監聽器類找不到異常解決

記錄兩個高頻 Java Web 開發報錯的排查步驟與解決方案，幫助快速定位問題。

錯誤 1：HTTP 404 - The requested resource is not available

現象：訪問 /hello.action 返回 404，控制台提示資源不可用。

排查：

1. 檢查 Tomcat 部署管理：Manager Deployments 面板是否正常打開。
2. 若打開報 NullPointerException，通常是伺服器啟動前備份舊部署導致。
3. 解決：在部署配置中將 Backup 改為 Delete，清理舊部署後重新發布。

錯誤 2：Error configuring application listener - ClassNotFoundException: org.springframework.web.context.ContextLoaderListener

現象：項目啟動報錯，找不到 Spring 監聽器類。

原因：缺少 spring-web 模塊 JAR 包（包含 ContextLoaderListener）。

解決：

• Maven 項目：在 pom.xml 添加依賴：

  <dependency>
      <groupId>org.springframework</groupId>
      <artifactId>spring-web</artifactId>
      <version>5.3.x</version> <!-- 對應 Spring 版本 -->
  </dependency>

• 非 Maven：手動下載對應版本 spring-web.jar 放入 WEB-INF/lib。
• 檢查部署組裝：確保依賴勾選 Maven Dependencies 導出至 WEB-INF/lib。

通用排查清單

• 確認 web.xml 中 listener-class 拼寫正確。
• 檢查 JDK/Tomcat 版本與 Spring 版本兼容性。
• 清理項目：mvn clean / Eclipse Project → Clean 後重新部署。
• 查看完整堆棧跟踪，定位首個 Caused by。