当前位置：首页 > news >正文

Maven 配置阿里云镜像加速

news 2025/8/2 6:05:19

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
Google	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