Maven 創建項目報錯：插件版本在倉庫找不到

錯誤現象

執行 mvn archetype:generate 或 IDE 創建 Maven 項目時，提示 Could not find artifact org.apache.maven.plugins:maven-archetype-plugin:jar:3.2.1 或類似插件版本缺失。

原因

• 本地倉庫損壞或不全。
• 遠程倉庫（中央倉庫/阿里云鏡像）暫時無該版本，或 settings.xml 鏡像配置指向了不完整的鏡像。
• 項目 pom.xml 父項指定了不存在的插件版本。

解決步驟

1. 強制更新快照/插件：mvn -U clean install。
2. 檢查 settings.xml 鏡像：推薦使用阿里云中央倉庫鏡像：

   <mirror>
     <id>aliyunmaven</id>
     <mirrorOf>central</mirrorOf>
     <name>阿里云公共倉庫</name>
     <url>https://maven.aliyun.com/repository/public</url>
   </mirror>
   

3. 降級插件版本**：在 pom.xml <pluginManagement> 中指定穩定版本（如 maven-archetype-plugin 3.1.2）。
4. 刪除本地倉庫損壞文件：rm -rf ~/.m2/repository/org/apache/maven/plugins/maven-archetype-plugin 後重試。

最佳實踐

• 企業內網部署 Nexus/Artifactory** 代理中央倉庫，避免外網不穩定。
• 提交 mvnw (Maven Wrapper) 到版本庫，統一構建環境。