MyEclipse 發布 Web 專案至 Tomcat 完整圖文教學：專案名稱映射、發布順序、常見問題排查

MyEclipse 發布 Web 專案至 Tomcat 完整圖文教學

MyEclipse 內建 Tomcat 管理功能，但專案名稱映射、發布順序、伺服器啟動時機常讓新手困擾。本文以圖文步驟詳細說明：專案部署配置、Context Root 修改、正確啟動順序 (先部署後啟動)、移除部署陷阱與常見問題排查。

一、部署介面概覽

• Deployed Projects：已部署至伺服器的專案列表。
• Add：從工作區選擇專案部署。
• Remove：從伺服器移除部署 (不刪除專案源碼)。
• Start/Stop/Restart：控制 Tomcat 生命週期。

二、關鍵配置：修改 Context Root (部署路徑)

預設部署路徑 = 專案名稱。若重命名專案 (Refactor → Rename)，**部署路徑不會自動更新**，導致 URL 存取 404。

修改步驟

1. 專案右鍵 → Properties
2. 左側選 MyEclipse → Web
3. Web Context Root 輸入框修改為期望路徑 (如 /myapp)
4. Apply → OK
5. 重新部署 (Remove → Add)

驗證：啟動 Tomcat 後訪問 https://localhost:8080/myapp/。

三、標準部署流程 (避坑指南)

1. 清理專案：Project → Clean... → 勾選專案 → Clean (確保編譯輸出最新)。
2. 部署專案：伺服器視圖 → Add → 選擇專案 → Finish (MyEclipse 會複製檔案至 webapps 或配置 Context.xml)。
3. 啟動伺服器：點擊 Start 圖示 (綠色三角形)。
4. 驗證：Console 輸出 Server startup in xxx ms，瀏覽器訪問首頁。

核心原則：先部署，後啟動。 若先啟動 Tomcat 再 Add 部署，熱部署有時失敗 (類載入器鎖定、JSP 編譯異常)。

四、移除部署陷阱

• 點 Remove 僅從伺服器移除，**不會刪除 webapps 下的資料夾/WAR** (需手動清理或重新部署覆蓋)。
• 若專案名變更，舊部署目錄殘留會導致衝突，建議 Stop → Remove → 手動刪除 webapps/舊目錄 → Clean → Add → Start。

五、常見問題排查表

六、進階：Deployment Assembly 依賴管理 (Maven 專案必看)

Maven 專案若 pom.xml 依賴正確，但部署到 Tomcat 缺少 JAR，請檢查：

1. 專案右鍵 → Properties → Deployment Assembly
2. 確認列表有 Maven Dependencies (來源: Java Build Path Entries)
3. 若無，點 Add → Java Build Path Entries → Maven Dependencies

此設定控制 WEB-INF/lib 內容，直接影響運行時類路徑。

七、總結

1. 修改 Context Root 必須在 Properties → MyEclipse → Web 設定，非專案重命名。
2. 標準流程：Clean → Add 部署 → Start 啟動。
3. Remove 不清理 webapps 目錄，變更專案名需手動刪除舊目錄。
4. Maven 專案必須驗證 Deployment Assembly 包含 Maven Dependencies。
5. 遇到疑難雜症：Stop → Remove → 刪 webapps/專案 → Clean → Add → Start (大招)。