Eclipse 整合 Tomcat 啟動失敗：版本不兼容與配置錯誤排查指南

常見報錯現象

• 控制台紅字：`Server Tomcat v9.0 failed to start`
• 彈窗：`Could not load the Tomcat server configuration`
• 端口衝突：`Address already in use: JVM_Bind :8080`

核心原因對照表

標準化配置流程 (推薦 Tomcat 8.5.x + Eclipse 2023+)

1. 下載 Tomcat 8.5.x (zip 版) → 解壓至 `D:\Tomcat85` (無中文、無空格)
2. Eclipse → Window → Preferences → Server → Runtime Environments → Add → Apache Tomcat v8.5 → Browse 選 `D:\Tomcat85` → Finish
3. Servers 視圖 → 右鍵 New → Server → 選擇剛添加的 Runtime → Next → 將專案 Add 到 Configured → Finish
4. 雙擊 Server → Server Locations → **Use Tomcat installation** (取消勾選 "Modules auto reload" 可提速)
5. 專案右鍵 Properties → Deployment Assembly → 確認源碼/資源映射正確
6. 清理：Project → Clean → Clean all projects → Server 右鍵 Clean → Clean Tomcat Work Directory → Start

進階診斷技巧

• 啟動日誌：雙擊 Server → Open launch configuration → Common → 勾選 "Allocate console" → 啟動時 Console 顯示完整 catalina.out
• 遠程除錯：Server → Open launch configuration → Arguments → VM arguments 加入 `-agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=8000` → Debug 模式啟動
• 檢查類加載衝突：控制台搜尋 `ClassNotFoundException` / `LinkageError` → 排查專案 WEB-INF/lib 與 Tomcat lib 重複 Jar (如 servlet-api.jar)

總結

**Tomcat 版本與 Eclipse WTP 適配器版本必須匹配**。穩妥組合：Eclipse 2023+ + Tomcat 8.5.x + JDK 8/11。按標準化流程配置 Server Locations、JRE、端口，90% 啟動失敗即可解決。