Maven 配置阿里云鏡像加速:
完整配置步驟(Windows 系統)
1. 找到 Maven 的 settings.xml
文件
- 全局配置:
D:\software\apache-maven-3.9.11\conf\settings.xml
- 用戶配置:
C:\Users\Admin\.m2\settings.xml
(推薦使用此位置)
2. 修改 settings.xml
文件
用文本編輯器打開文件,添加以下配置:
<settings><!-- 本地倉庫位置 --><localRepository>C:\Users\Admin\.m2\repository</localRepository><!-- 鏡像配置 --><mirrors><!-- 阿里云主鏡像 --><mirror><id>aliyunmaven</id><name>阿里云公共倉庫</name><url>https://maven.aliyun.com/repository/public</url><mirrorOf>central,jcenter,google,spring,gradle-plugin,grails-core,apache-snapshots</mirrorOf></mirror><!-- 阿里云插件鏡像 --><mirror><id>aliyunPlugin</id><name>阿里云插件倉庫</name><url>https://maven.aliyun.com/repository/central</url><mirrorOf>plugin</mirrorOf></mirror></mirrors><!-- 可選:配置下載線程數 --><profiles><profile><id>speedup</id><properties><maven.artifact.threads>8</maven.artifact.threads></properties></profile></profiles><activeProfiles><activeProfile>speedup</activeProfile></activeProfiles>
</settings>
3. 驗證配置生效
# 清除本地緩存(可選)
mvn dependency:purge-local-repository# 重新構建項目
mvn clean install -U
4. 高級優化配置(可選)
在 settings.xml
中添加以下配置加速下載:
<settings>...<!-- 并行構建配置 --><build><pluginManagement><plugins><plugin><groupId>org.apache.maven.plugins</groupId><artifactId>maven-resources-plugin</artifactId><version>3.3.1</version><configuration><useDefaultDelimiters>true</useDefaultDelimiters><parallel>true</parallel><threadCount>4</threadCount></configuration></plugin></plugins></pluginManagement></build><!-- 超時設置 --><servers><server><id>aliyunmaven</id><configuration><httpConfiguration><all><connectionTimeout>60000</connectionTimeout><readTimeout>60000</readTimeout></all></httpConfiguration></configuration></server></servers>
</settings>
5. 解決特定倉庫問題
如果某些依賴仍從中央倉庫下載,在 pom.xml
中強制指定倉庫:
<repositories><repository><id>aliyun</id><url>https://maven.aliyun.com/repository/public</url><releases><enabled>true</enabled></releases><snapshots><enabled>true</enabled><updatePolicy>always</updatePolicy></snapshots></repository>
</repositories><pluginRepositories><pluginRepository><id>aliyun-plugin</id><url>https://maven.aliyun.com/repository/public</url></pluginRepository>
</pluginRepositories>
6. 命令行覆蓋(臨時使用)
mvn clean install -Dmaven.wagon.http.retryHandler.count=3 -Dmaven.wagon.httpconnectionManager.ttlTimeout=30000 -Dmaven.wagon.http.readTimeout=60000
常見問題解決
1. 下載卡在某個進度
# 跳過測試并禁用校驗
mvn clean install -DskipTests -Dmaven.wagon.http.ssl.insecure=true -Dmaven.wagon.http.ssl.allowall=true
2. 特定依賴下載失敗
手動下載并安裝:
mvn install:install-file -Dfile=path/to/jar -DgroupId=group.id -DartifactId=artifact-id -Dversion=version -Dpackaging=jar
3. 查看依賴樹
mvn dependency:tree -Dverbose
阿里云鏡像地址參考
倉庫類型 | 阿里云鏡像地址 |
---|---|
中央倉庫 | https://maven.aliyun.com/repository/public |
https://maven.aliyun.com/repository/google | |
Spring | https://maven.aliyun.com/repository/spring |
Gradle Plugin | https://maven.aliyun.com/repository/gradle-plugin |
Apache Snapshots | https://maven.aliyun.com/repository/apache-snapshots |
通過以上配置,Maven 下載速度通常可提升 5-10 倍。如果仍有問題,建議檢查網絡連接或嘗試使用 VPN 解決國際帶寬限制問題。