解決 Eclipse Tomcat 啟動正常但訪問項目報 404 錯誤的完整指南

問題現象

在 Eclipse 中開發 Web 項目時，Tomcat 啟動控制台無任何報錯，且 webapps 目錄下確實存在項目文件夾，但瀏覽器訪問 https://localhost:8080/項目名 卻始終返回 404 錯誤，甚至連 Tomcat 默認的貓頁面都能正常顯示，僅項目路徑無法訪問。

核心排查方向

1. URL 路徑拼寫錯誤

檢查瀏覽器地址欄是否包含正確的 Context Path（項目名），注意大小寫敏感性，避免多餘斜槓或拼寫偏差。

2. 項目啟動過程中有異常被吞噬

查看 Eclipse 控制台完整日誌，重點關注 SEVERE 級別錯誤。常見原因包括：web.xml 配置錯誤、Servlet 類找不到、依賴 JAR 包缺失、監聽器/過濾器初始化失敗等。修復報錯後重新發布。

3. 項目未真正部署成功

在 Servers 視圖中右鍵 Tomcat 選擇 Clean，再 Clean Tomcat Work Directory，最後重新發布項目。若仍無效，刪除 .metadata/.plugins/org.eclipse.wst.server.core 下對應項目文件夹後重試。

4. 缺少歡迎頁面或靜態資源放錯位置

• 確認 web.xml 配置了 <welcome-file-list>（如 index.jsp），且該文件確實存在於 WebContent 或 src/main/webapp 根目錄。
• 若直接訪問具體 .jsp/.html 仍 404，檢查文件是否誤放在 WEB-INF 目錄下（該目錄受容器保護，不可直接訪問）。

5. Eclipse 使用的 Tomcat 與實際啟動的不是同一實例

在 Server 編輯器中確認 Server Locations 選擇 Use Tomcat installation，且 Deploy path 指向正確的 wtpwebapps。避免同時運行命令行啟動的 Tomcat 導致端口衝突或部署目錄不一致。

快速自查清單

1. Console 無紅字報錯？
2. 項目右鍵 Run As → Run on Server 時目標 Server 正確？
3. webapps/wtpwebapps 下項目文件夾結構完整（含 WEB-INF/web.xml、classes、lib）？
4. 瀏覽器訪問 https://localhost:8080/項目名/具體頁面.jsp 是否可達？

逐項排查通常能定位 90% 以上的 404 根因。若問題仍存，請提供完整控制台日誌、web.xml 及項目結構截圖以便進一步分析。