Eclipse 從 SVN 檢出 Maven 項目無法部署 Tomcat？標準導入流程一鍵修復

故障現象

Eclipse 環境下，從 SVN 檢出的 Maven Web 項目，右鍵 Run As → Run on Server 時 Tomcat 未列出該項目，或報錯「無法部署」，控制台無輸出。

根因分析

SVN 僅存源碼，缺失 Eclipse WTP（Web Tools Platform）所需的項目面元數據（.settings/org.eclipse.wst.common.component 等），導致 Eclipse 不識別為「Dynamic Web Module」，Tomcat 自然找不到部署入口。

標準修復步驟

1. File → Import → Maven → Existing Maven Projects
2. 選中項目根目錄（含 pom.xml），Finish。
3. Maven 導入過程中會自動：
   - 解析 pom.xml 中的 <packaging>war</packaging>
   - 生成 .project、.classpath、.settings/
   - 啟用 WTP Facet（Dynamic Web Module, Java, JavaScript）
   - 在 Deployment Assembly 配置源碼/資源輸出路徑

驗證部署配置

導入後，右鍵項目 → Properties → Deployment Assembly，確認：

• src/main/java → WEB-INF/classes
• src/main/resources → WEB-INF/classes
• src/main/webapp → /（Web 根目錄）
• Maven Dependencies → WEB-INF/lib

常見遺留問題

• web.xml 缺失或版本過低：Servlet 3.0+ 可無 web.xml，但需在 pom.xml 配置 maven-war-plugin <failOnMissingWebXml>false</failOnMissingWebXml>。
• Tomcat 版本不匹配：項目 Facet 要求的 Dynamic Web Module 版本與 Server Runtime 不一致，Properties → Project Facets → Runtimes 勾選正確 Tomcat。
• 端口衝突：修改 server.xml <Connector port="8080" ...>。

核心口訣：先 Import Maven Project，再配 Tomcat Runtime，最後检查 Deployment Assembly，告别手工配置痛苦。