讲师中心 微信公众号
AI工具推荐 视频效率加速

Maven settings.xml mirror配置 阿里云镜像仓库加速

梦浩小哥_1507

梦浩小哥_1507

发布时间:2026-03-08 11:11:02

|

463人浏览过

|

来源于php中文网

原创

mirrorOf 应设为 才能真正生效,因 匹配所有仓库;阿里云镜像地址须用 https://maven.aliyun.com/repository/public;需确保 mirror 置于 settings.xml 的 标签下,且清除本地元数据缓存验证生效。

maven settings.xml mirror配置 阿里云镜像仓库加速

mirrorOf 设置成 * 才能真正生效

很多人配了阿里云镜像但下载还是慢,根本原因是 mirrorOf 值写成了 central 或留空。Maven 只对匹配到的仓库走镜像,而默认的中央仓库 ID 是 central,但如果你项目里又声明了其他仓库(比如 Spring 的 spring-milestones),它们不会被 central 匹配到。* 表示“所有仓库”,这是最稳妥的写法。

  • mirrorOf 推荐值:*(不是 central,也不是 external:*)
  • 如果必须排除某些私有仓库,才用 !repo-id, * 这种排除语法,但日常开发极少需要
  • 改完记得删掉 ~/.m2/repository/.cache/ 下的元数据缓存,否则旧重定向可能还在生效

settings.xml 里 <mirror></mirror> 必须放在 <mirrors></mirrors> 标签下

常见错误是把 <mirror></mirror> 直接塞进 <profiles></profiles> 或 <servers></servers> 里,或者漏写外层 <mirrors></mirrors>。Maven 只认顶层 <mirrors></mirrors> 下的 <mirror></mirror>,其他位置一律忽略。

  • 正确结构:根节点 <settings></settings> → <mirrors></mirrors> → <mirror></mirror>
  • 别在 <profile></profile> 里配 mirror——profile 里的 mirror 不生效
  • 多个 mirror 时,Maven 按顺序匹配第一个 mirrorOf 匹配成功的,后面的会被跳过

阿里云镜像地址要用 https://maven.aliyun.com/repository/public

网上很多教程还写着老地址 http://maven.aliyun.com/nexus/content/groups/public/,这个 HTTP 地址已停用,且不支持 HTTPS 重定向,会直接报 Connection refused 或 PKIX path building failed。

  • 当前唯一有效地址:https://maven.aliyun.com/repository/public
  • 别漏掉 /repository/public 后缀,只写到 /repository 会 403
  • 国内网络下,这个地址响应稳定;海外用户反而可能更慢,此时应考虑用 https://repo1.maven.org/maven2/ 或就近镜像

验证是否生效:看 Maven 日志里的 Downloading from aliyunmaven

运行 mvn clean compile -X(加 -X 开启 debug 日志),搜索日志中是否有 Downloading from aliyunmaven。如果看到的是 Downloading from central 或其他名字,说明配置没生效。

  • 检查 settings.xml 是否被正确加载:日志开头会打印 Using settings file: ...
  • 确认没被项目级 pom.xml 中的 <repositories></repositories> 覆盖——项目里显式定义仓库时,mirror 默认不接管
  • IDE(如 IntelliJ)可能用自带的 Maven 或独立 settings 文件,要检查 IDE 的 Maven 配置路径是否指向你改的那个 settings.xml

最常被忽略的一点:公司内网环境可能有代理或白名单限制,即使 settings.xml 完全正确,https://maven.aliyun.com 也可能被防火墙拦截。这时候得找运维确认出向域名是否放行,而不是反复调配置。

热门AI工具

更多
SkildArt
SkildArt Hot

SkildArt是一款AI文本写作工具,一站式 AI 视觉创作平台。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

墨刀AI
墨刀AI Hot

一款AI图像与设计工具,主要用于产品经理的专属智能体,适合需要提升相关任务效率的用户。

花生AI
花生AI Hot

一款AI视频创作工具,主要用于B站推出的AI视频创作工具,适合需要提升相关任务效率的用户。

讯飞智作

讯飞智作是一款AI视频创作工具,AI文本配音工具,数字人课程、营销视频制作。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

UpDream
UpDream Hot

一款AI视频创作工具,主要用于哔哩哔哩推出的自研AI视频创作工具,适合需要提升相关任务效率的用户。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

小橡皮AI

一款AI工具,主要用于小橡皮一键去AI味,将机器味重的内容改得更有活人感,防止因为 AI 内容被平台打上 AI 标签,以及限流,适合需要提升相关任务效率的用户。

相关专题

更多
spring框架介绍
spring框架介绍

本专题整合了spring框架相关内容,想了解更多详细内容,请阅读专题下面的文章。

2791

2025.08.06

Java Spring Security 与认证授权
Java Spring Security 与认证授权

本专题系统讲解 Java Spring Security 框架在认证与授权中的应用,涵盖用户身份验证、权限控制、JWT与OAuth2实现、跨站请求伪造(CSRF)防护、会话管理与安全漏洞防范。通过实际项目案例,帮助学习者掌握如何 使用 Spring Security 实现高安全性认证与授权机制,提升 Web 应用的安全性与用户数据保护。

497

2026.01.26

Java Maven专题
Java Maven专题

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

4280

2025.09.15

Java Maven/Gradle 构建与依赖管理合集
Java Maven/Gradle 构建与依赖管理合集

系统讲解 Java 项目构建工具的使用与进阶配置,涵盖 Maven 的 POM 文件结构、生命周期(clean/compile/package/install/deploy)与插件机制、依赖范围(compile/provided/test/runtime)与传递依赖管理、多模块聚合与继承、私有 Nexus 仓库发布,以及 Gradle 的 Groovy / Kotlin DSL 语法、Task 自定义与增量构建、依赖版本目录(Versi

389

2026.05.09

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

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

4864

2024.04.01

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

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

6317

2024.08.01

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

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

2562

2024.11.28

http500解决方法
http500解决方法

http500解决方法有检查服务器日志、检查代码错误、检查服务器配置、检查文件和目录权限、检查资源不足、更新软件版本、重启服务器或寻求专业帮助等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

3803

2023.11.09

Uvicorn 报错与问题解决教程
Uvicorn 报错与问题解决教程

本专题汇总了Uvicorn服务器常见问题与报错解决的教程合集,涵盖启动失败、端口占用、模块导入错误、事件循环冲突及热重载失效等典型故障的排查思路。同时整理了多进程与Worker配置、SSL/HTTPS证书报错、跨域与代理配置等实战解决方案,助你快速定位并解决Uvicorn运行中的各类问题。

0

2026.11.02

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
通义灵码手册
通义灵码手册

共0课时 | 0人学习

第二十二期_综合实战
第二十二期_综合实战

共96课时 | 11.9万人学习

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

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn