0

0

Maven settings.xml配置阿里云镜像 加速Java依赖包下载速度

畫卷琴夢

畫卷琴夢

发布时间:2026-02-24 12:39:48

|

880人浏览过

|

来源于php中文网

原创

改 settings.xml 能加速 maven 下载,因为将默认中央仓库替换为国内阿里云镜像(https://maven.aliyun.com/repository/public),物理距离近、带宽足;需修改用户级 ~/.m2/settings.xml(windows 为 %userprofile%.m2\settings.xml),在 中配置 *,并验证日志中下载 url 是否变为 aliyun.com。

maven settings.xml配置阿里云镜像 加速java依赖包下载速度

为什么改 settings.xml 能加速 Maven 下载

因为默认 Maven 从中央仓库 https://repo.maven.apache.org/maven2/ 拉包,国内直连慢、不稳定。阿里云镜像(https://maven.aliyun.com/repository/public)是官方认可的缓存节点,物理距离近、带宽足,改完后所有 mvn clean install 类命令都会自动走这个源。

怎么改本地 settings.xml 文件

不是改项目里的 pom.xml,也不是改 IDE 内嵌的 Maven 配置,而是改你机器上 Maven 安装目录或用户目录下的全局/用户级 settings.xml

  • 优先改用户级:在 ~/.m2/settings.xml(macOS/Linux)或 %USERPROFILE%\.m2\settings.xml(Windows)——这个对当前用户生效,不影响别人,也避开权限问题
  • 如果文件不存在,就新建一个;如果存在,只补全 <mirrors></mirrors> 块,别动已有配置
  • 镜像必须设为 <mirrorof>*</mirrorof>,表示“所有仓库都走它”,写成 centralpublic 会漏包
<mirrors>
  <mirror>
    <id>aliyunmaven</id>
    <mirrorOf>*</mirrorOf>
    <name>Aliyun Maven</name>
    <url>https://maven.aliyun.com/repository/public</url>
  </mirror>
</mirrors>

常见错误现象和验证方法

改完不生效?大概率是路径错、格式错、或者被其他配置覆盖了:

Scribble Diffusion
Scribble Diffusion

使用AI将你的草图变成精致的图像

下载
  • 执行 mvn -X clean compile 看日志里下载 URL 是否变成 maven.aliyun.com —— 这是最准的验证方式
  • 如果还走 repo.maven.apache.org,检查是否误改了 $M2_HOME/conf/settings.xml 却没配 M2_HOME 环境变量,导致 Maven 根本没读它
  • IDE(如 IntelliJ)可能缓存旧配置,改完后要重启 IDE 或手动触发 “Reload project”
  • 某些公司私有仓库要求保留特定 mirrorOf 值(比如 external:*),此时不能简单写 *,得按内部规范调整

镜像地址和兼容性注意点

阿里云镜像地址有过几次变更,老教程里写的 http://maven.aliyun.com/nexus/content/groups/public/ 已弃用,HTTP 也不安全:

立即学习Java免费学习笔记(深入)”;

  • 必须用 HTTPS,当前稳定地址是 https://maven.aliyun.com/repository/public
  • 这个地址支持 Maven 3.0+ 所有版本,但如果你用的是极老的 Maven 2.x,可能需要降级到 https://maven.aliyun.com/nexus/content/groups/public(不推荐)
  • 它只代理 public 仓库,不包含 snapshotsreleases 等子仓库,所以不要在 <repository></repository> 里重复配阿里云地址——镜像和仓库配置混用容易冲突
实际生效的关键就两件事:文件放对位置、<mirrorof></mirrorof> 写成 *。其它任何花式写法,包括加 profile、套条件、换 id 名,都是在增加出错概率。

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
Java Maven专题
Java Maven专题

本专题聚焦 Java 主流构建工具 Maven 的学习与应用,系统讲解项目结构、依赖管理、插件使用、生命周期与多模块项目配置。通过企业管理系统、Web 应用与微服务项目实战,帮助学员全面掌握 Maven 在 Java 项目构建与团队协作中的核心技能。

0

2025.09.15

pdf怎么转换成xml格式
pdf怎么转换成xml格式

将 pdf 转换为 xml 的方法:1. 使用在线转换器;2. 使用桌面软件(如 adobe acrobat、itext);3. 使用命令行工具(如 pdftoxml)。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

1932

2024.04.01

xml怎么变成word
xml怎么变成word

步骤:1. 导入 xml 文件;2. 选择 xml 结构;3. 映射 xml 元素到 word 元素;4. 生成 word 文档。提示:确保 xml 文件结构良好,并预览 word 文档以验证转换是否成功。想了解更多xml的相关内容,可以阅读本专题下面的文章。

2109

2024.08.01

xml是什么格式的文件
xml是什么格式的文件

xml是一种纯文本格式的文件。xml指的是可扩展标记语言,标准通用标记语言的子集,是一种用于标记电子文件使其具有结构性的标记语言。想了解更多相关的内容,可阅读本专题下面的相关文章。

1134

2024.11.28

windows查看端口占用情况
windows查看端口占用情况

Windows端口可以认为是计算机与外界通讯交流的出入口。逻辑意义上的端口一般是指TCP/IP协议中的端口,端口号的范围从0到65535,比如用于浏览网页服务的80端口,用于FTP服务的21端口等等。怎么查看windows端口占用情况呢?php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

1256

2023.07.26

查看端口占用情况windows
查看端口占用情况windows

端口占用是指与端口关联的软件占用端口而使得其他应用程序无法使用这些端口,端口占用问题是计算机系统编程领域的一个常见问题,端口占用的根本原因可能是操作系统的一些错误,服务器也可能会出现端口占用问题。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

1152

2023.07.27

windows照片无法显示
windows照片无法显示

当我们尝试打开一张图片时,可能会出现一个错误提示,提示说"Windows照片查看器无法显示此图片,因为计算机上的可用内存不足",本专题为大家提供windows照片无法显示相关的文章,帮助大家解决该问题。

823

2023.08.01

windows查看端口被占用的情况
windows查看端口被占用的情况

windows查看端口被占用的情况的方法:1、使用Windows自带的资源监视器;2、使用命令提示符查看端口信息;3、使用任务管理器查看占用端口的进程。本专题为大家提供windows查看端口被占用的情况的相关的文章、下载、课程内容,供大家免费下载体验。

460

2023.08.02

苹果官网入口与在线访问指南_中国站点快速直达与iPhone查看方法
苹果官网入口与在线访问指南_中国站点快速直达与iPhone查看方法

本专题汇总苹果官网最新可用入口及中国站点访问方式,涵盖官网直达链接、iPhone官方页面查看方法与常见访问说明,帮助用户快速进入苹果官方网站,便捷了解产品信息与官方服务。

2

2026.02.24

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Kotlin 教程
Kotlin 教程

共23课时 | 3.9万人学习

C# 教程
C# 教程

共94课时 | 10.1万人学习

Java 教程
Java 教程

共578课时 | 71.5万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号