Eclipse 將 Web 項目轉為 Maven 項目：完整流程與目錄結構規範

問題現象

通過 Eclipse Configure > Convert to Maven Project 轉換後，項目僅多出 pom.xml 和 target 目錄，原有 Web 目錄結構（如 WebRoot/WEB-INF）未變，看起來不像標準 Maven 結構（src/main/java, src/main/webapp 等），不知後續如何規範化處理。

標準 Maven Web 項目目錄結構

project-root/
├── pom.xml
├── src/
│   ├── main/
│   │   ├── java/          # Java 源碼
│   │   ├── resources/     # 配置文件、屬性文件
│   │   └── webapp/        # Web 資源（jsp, css, js, WEB-INF/web.xml）
│   └── test/
│       ├── java/
│       └── resources/
└── target/                # 編譯輸出、打包產物（自動生成）

Eclipse 轉換後的完整規範化步驟

1. 設置 Project Facets（關鍵）

• 右鍵項目 > Properties > Project Facets；
• 確保勾選 Dynamic Web Module（版本匹配 Servlet 規範）、Java、JavaScript；
• 點擊 Runtimes 選中目標 Server（如 Tomcat 9），應用；
• 這步會自動識別/創建標準源碼目錄並配置 Build Path。

2. 調整源碼目錄映射

若原代碼在 src 或 JavaSource 等非標準目錄：

• Properties > Java Build Path > Source 頁籤；
• 移除舊源碼目錄，Add Folder 選中 src/main/java（需先手動創建）；
• 將 WebRoot/WEB-INF/classes 等舊輸出目錄移除，輸出目錄設為 target/classes（Maven 默認）。

3. 遷移 Web 資源

• 將 WebRoot 或 WebContent 下內容移動至 src/main/webapp；
• 確保 web.xml 位於 src/main/webapp/WEB-INF/web.xml；
• 若使用 maven-war-plugin，可在 pom.xml 配置 <webXml> 指定路徑。

4. 處理依賴庫

• 刪除 WEB-INF/lib 下手動放入的 JAR；
• 在 pom.xml <dependencies> 中聲明所有依賴（含 servlet-api 設為 provided 作用域）；
• 右鍵項目 > Maven > Update Project 強制同步。

5. 驗證部署組裝

• Properties > Deployment Assembly 應包含：
  /src/main/java → WEB-INF/classes
/src/main/resources → WEB-INF/classes
/src/main/webapp → /
Maven Dependencies → WEB-INF/lib
• 右鍵項目 > Run As > Maven install 生成 WAR，檢查結構是否正確。

常見問題排查

• JSP 報錯找不到標簽庫：檢查 Deployment Assembly 是否遺漏 Maven Dependencies；
• 類找不到：確認 Java Build Path > Source 輸出目錄一致性；
• Tomcat 發布為空：清理 Server、Maven > Update Project、重新添加項目到 Server。

總結

Eclipse 的「Convert to Maven Project」僅是啟動 Maven 性質的第一步。要得到規範、可構建、可部署的 Maven Web 項目，必須配置 Facets、遷移目錄結構、聲明依賴、校驗 Deployment Assembly。完成上述步驟後，項目即具備標準 Maven 生命周期管理能力。