Maven 入門常見問題彙總：代理、私服、Eclipse 整合

記錄 Maven 初學者最易遇到的三大塹坑及解決方案，作為快速排查參考。

問題一：archetype 插件無法下載

The plugin 'org.apache.maven.plugins:maven-archetype-plugin' does not exist or valid version could be found

原因：使用代理上網但 Maven 未配置代理。

解決：編輯 maven/conf/settings.xml，啟用 <proxy> 節點：

<proxy>
  <host>iproxy.example.com</host> <!-- 不要加 https:// -->
  <port>8080</port>
  <username>user</username> <!-- 可選 -->
  <password>pass</password> <!-- 可選 -->
</proxy>

問題二：Artifactory 私服安裝報錯

現象：配置 Maven 使用私服後仍從中央倉庫下載；Artifactory 控制台點擊 Virtual Repositories → repo 拋出 ArrayIndexOutOfBoundsException。

原因：Artifactory 1.3.0-beta1 版本 Bug。

解決：降級使用穩定版 1.2.5 final，問題即時消失。

問題三：Eclipse 導入 Maven 項目報缺少 M2_REPO 變量

現象：mvn eclipse:eclipse 生成項目導入 Eclipse 編譯錯誤，提示缺少 Classpath Variable M2_REPO。

解決：Eclipse 中設置 Classpath Variable：

1. Window → Preferences → Java → Build Path → Classpath Variables
2. New → Name: M2_REPO，Path: 你的本地 Maven 倉庫路徑 (如 ~/.m2/repository)
3. 重新構建項目

快速檢查清單

• ☑ 代理配置正確（host 無 https://）
• ☑ 私服版本穩定（避免 beta）
• ☑ Eclipse M2_REPO 變量指向正確本地倉庫
• ☑ settings.xml 中 localRepository 統一管理倉庫位置