Eclipse 整合 Tomcat 專案訪問 404 錯誤排查清單

現象

Tomcat 啟動成功，https://localhost:8080 顯示預設頁面，但訪問 https://localhost:8080/專案名 返回 404。

常見原因與解決步驟

1. 專案未部署至 Tomcat
   在 Eclipse Servers 視圖中，右鍵 Tomcat 選擇 Add and Remove，確認專案在 Configured 列表中。若無，添加並重新發布。
2. Context Path 設定錯誤
   專案右鍵 → Properties → Web Project Settings，確認 Context root 與 URL 中的專案名一致。或檢查 server.xml 中 <Context path="/專案名" ...> 設定。
3. web.xml 缺少 welcome-file-list
   確保 WEB-INF/web.xml 定義預設頁面：
   

   <welcome-file-list>
     <welcome-file>index.jsp</welcome-file>
   </welcome-file-list>

4. 專案建置輸出路徑錯誤
   Properties → Java Build Path → Source，確認 Default output folder 指向 WebContent/WEB-INF/classes（或 target/classes）。
5. Tomcat 發布目錄未同步
   在 Servers 視圖右鍵 Tomcat → Clean → Clean Tomcat Work Directory，再重新啟動。
6. 端口衝突或多實例
   確認啟動的 Tomcat 正是 Eclipse 管理的實例，檢查 netstat -ano | findstr 8080 對應的 PID。

快速驗證

在 webapps 目錄下是否有專案資料夾或 .war 檔案？若無，代表部署失敗，請重點檢查第 1、4 項。

進階排查

查看 Tomcat 日誌 logs/localhost.日期.log 與 logs/catalina.日期.log，搜尋 SEVERE 或專案名關鍵字，通常能定位具體錯誤（如類找不到、資料庫連線失敗導致啟動中斷）。