Tomcat 啟動報錯 "Demo13 is required and cannot be removed" 徹底解決指南

現象描述

在 Eclipse/MyEclipse 中運行 Web 項目時，Run As → Run on Server 選擇項目名稱頂部顯示紅叉錯誤：Demo13 is required and cannot be removed from the server。項目 Build Path 配置正常，Tomcat 安裝無誤，但運行直接報錯失敗。附圖顯示 Server 視圖中項目狀態異常。

根本原因

Eclipse 工作空間元數據中殘留了多個/舊的 Tomcat 服務器配置，導致部署映射衝突。常見於：

• 曾安裝過多個 Tomcat 版本（如 Tomcat 8/9 並存）。
• 手動刪除過 Server 視圖中的服務器實例，但 .metadata/.plugins/org.eclipse.wst.server.core 內殘留配置。
• 項目曾關聯舊 Server 實例，現指向新實例但映射未清理。

標準解決步驟（親測有效）

方法一：Server 視圖重置（最快、推薦）

1. 打開 Servers 視圖（Window → Show View → Servers）。
2. 右鍵報錯的 Tomcat 服務器 → Delete 刪除（勾選 "Delete unused server configurations"）。
3. 右鍵 Servers 視圖空白處 → New → Server → 重新創建 Tomcat 實例，指向正確安裝目錄。
4. 右鍵項目 → Properties → Targeted Runtimes → 勾選新建的 Tomcat 版本。
5. 右鍵項目 → Run As → Run on Server → 選擇新 Server → 完成。

方法二：清理工作空間元數據（徹底）

若方法一無效，關閉 Eclipse，刪除工作空間下隱藏文件夾：

workspace/.metadata/.plugins/org.eclipse.wst.server.core/

重啟 Eclipse，重新配置 Server 與項目關聯。注意：此操作會清空所有 Server 配置、斷點、任務記錄等，請備份重要調試信息。

方法三：檢查項目部署組件

1. 右鍵項目 → Properties → Deployment Assembly。
2. 確保 src/main/webapp (或 WebContent) 映射到 /，src/main/java 編譯輸出映射到 /WEB-INF/classes，Maven 依賴映射到 /WEB-INF/lib。
3. 移除多餘/衝突的映射條目。

圖示說明

上圖典型特徵：Server 視圖中項目前有紅叉，提示 "required and cannot be removed"。

預防措施

• 避免在同一工作空間頻繁切換多個 Tomcat 版本。
• 刪除 Server 時務必在 Servers 視圖右鍵 Delete，而非直接刪除文件夾。
• 使用 Maven/Gradle 管理依賴，減少手動 Build Path 操作導致的元數據不一致。

總結

此錯誤本質是 Eclipse WTP（Web Tools Platform）服務器元數據與項目關聯不同步。通過「刪除舊 Server 實例 → 重新創建 → 重新綁定項目」三步操作，可 100% 解決。切勿嘗試修改 server.xml、context.xml 等配置文件，治標不治本。