Eclipse 整合 Tomcat 啟動失敗：端口衝突與雙實例衝突完整排查指南

錯誤現象

Eclipse 發布 Web 專案到 Tomcat 時啟動失敗，但單獨啟動 Tomcat 卻正常。錯誤日誌顯示：

嚴重: Failed to destroy end point associated with ProtocolHandler ["ajp-nio-8088"]
java.lang.NullPointerException
at org.apache.tomcat.util.net.NioEndpoint.releaseCaches(NioEndpoint.java:302)
...

已嘗試修改 AJP 端口（8009→8088、8007），問題依舊，排除端口佔用可能。

根本原因：Eclipse 內嵌 Tomcat 與外部 Tomcat 衝突

Eclipse（特別是 Eclipse for Java EE / STS）預設內嵌一個 Tomcat 執行個體。當你在 Server 視圖配置外部 Tomcat 時，若未禁用內嵌實例，兩者會嘗試綁定相同端口（HTTP 8080、AJV 8009、關閉端口 8005），導致資源競爭與 NIO 端點銷毀異常。

圖解解決步驟

1. 打開 Window → Preferences（Windows/Linux）或 Eclipse → Preferences（macOS）
2. 搜尋 Tomcat 關鍵字，定位 Server → Runtime Environments
3. 列表中會出現兩個 Tomcat：
   • Eclipse 內嵌 Tomcat（通常標記為 "Apache Tomcat vX.X" 無路徑）
   • 你自行安裝的 Tomcat（顯示實際安裝路徑）
4. 選中內嵌 Tomcat，點擊 Disable 禁用
5. 選中外部 Tomcat，確保 Enable 狀態
6. Apply & Close，重啟 Eclipse

進階排查：server.xml 端口配置檢查

若禁用內嵌實例後仍失敗，檢查外部 Tomcat conf/server.xml 三大端口無衝突：

<Server port="8005" shutdown="SHUTDOWN">  <!-- 關閉端口 -->
<Connector port="8080" protocol="HTTP/1.1" />        <!-- HTTP 端口 -->
<Connector port="8009" protocol="AJP/1.3" redirectPort="8443" />  <!-- AJP 端口 -->

使用 netstat -ano | findstr "8005 8080 8009" 確認無其他進程佔用。

Eclipse 專項配置優化

• Server 視圖：右鍵 Server → Properties → Switch Location → "Use Tomcat installation" 確保部署路徑指向外部實例
• Deployment Assembly：確認專案輸出路徑正確映射到 wtpwebapps
• 清理工作目錄：Server 右鍵 → Clean → Clean Tomcat Work Directory

常見誤區

「我改了 AJP 端口就能解決」——錯誤。HTTP、Shutdown 端口同樣衝突，且 NIO 端點異常往往是雙實例並發關閉導致的競態條件，非單純端口問題。