Eclipse Maven 執行報 ClassNotFoundException：多模塊依賴缺失與構建生命周期排查

Eclipse 中運行 Maven 命令 (clean、install、compile 等) 均報 ClassNotFoundException，通常是**多模塊項目間依賴未正確配置**或**構建順序錯誤**導致類未編譯到輸出目錄。

核心排查步驟

1. 檢查模塊間依賴聲明：
   • 父 POM `` 包含所有子模塊。
   • 子模塊 `` 指向正確父坐標。
   • 依賴模塊在 `` 中聲明 `compile` (默認)，且 `` 使用 `${project.version}` 統一管理。
2. Eclipse 專案配置同步：
   • 右鍵項目 → Maven → **Update Project** → 勾選 **Force Update of Snapshots/Releases**。
   • 右鍵項目 → Properties → **Maven** → 確認 **Resolve dependencies from Workspace** 勾選 (工作空間解析)，優先使用本地模塊而非倉庫舊版本。
3. 構建順序與生命周期：
   • 命令行執行 mvn clean install -DskipTests 觀察反應堆構建順序是否符合依賴拓撲。
   • 若模塊 A 依賴模塊 B，反應堆必須先構建 B 再構建 A。Maven 自動根據依賴圖排序，但循環依賴會導致失敗。
4. 輸出目錄檢查：
   • 目標模塊 target/classes 下是否生成對應 .class 文件？若無，檢查 pom.xml `` 配置是否正確 (默認 src/main/java)。

常見具體原因

一鍵修復腳本 (命令行)

cd 项目根目录
mvn clean install -DskipTests -U  # -U 強制更新快照依賴
# 若仍失敗，刪除 ~/.m2/repository/對應groupId 目錄後重試

原則：**命令行構建成功為準**，Eclipse 只是 IDE 視圖，優先解決 Maven 原生構建問題，再同步 IDE 狀態。