Maven 常見錯誤排查指南：原型解析失敗與快照緩存卡住

錯誤一：Could not resolve archetype

現象

Could not resolve archetype org.apache.maven.archetypes:maven-archetype-quickstart:RELEASE
Missing org.apache.maven.archetypes:maven-archetype-quickstart:pom:RELEASE

原因

Eclipse 建立專案時使用自訂 Maven 倉庫（如 Nexus），但 Nexus 服務未啟動。Maven 嘗試下載原型失敗後，將失敗記錄於本地倉庫的 .lastUpdated 檔案，後續即使 Nexus 啟動，Maven 在更新間隔內不會重試。

解決步驟

1. 刪除本地倉庫中對應原型的目錄（含 .lastUpdated 檔）。
2. 切換 Workspace 或在 Eclipse 中 Maven > Update Project 勾選 Force Update of Snapshots/Releases。
3. 確認 Nexus 服務已啟動且可訪問。

錯誤二：was cached in the local repository, resolution will not be reattempted

現象

was cached in the local repository, resolution will not be reattempted until the update interval of nexus has elapsed or updates are forced

原因

同樣是首次下載失敗留下快照，Maven 拒絕在更新間隔內重試。

快速修復

1. 進入 Nexus 儲存目錄：$NEXUS_WORK/storage/central。
2. 找到下載失敗的構件目錄，刪除該目錄下的 .lastUpdated、.error 等標記檔。
3. 在 Eclipse 執行 Maven Install 或命令列 mvn clean install -U 強制更新。

預防建議

• 在 settings.xml 中配置 <updatePolicy>always</updatePolicy> 針對快照倉庫。
• 使用 mvn dependency:purge-local-repository 定期清理無效快取。
• 團隊統一使用 Mirror 配置指向穩定的代理倉庫，減少單點故障。