wxk1991.com
IDEA Maven 下载依赖慢解决方案（阿里云镜像）
wxk1991 Lv3
  2026-05-21 23:00:00   2026-05-26 10:38:43  

IDEA Maven 下载依赖慢解决方案（阿里云镜像）

很多人在使用：

  • IntelliJ IDEA
  • Maven
  • SpringBoot

时，都会遇到：

1
Maven 下载依赖特别慢

甚至：

  • 卡死
  • 下载失败
  • Connection reset
  • Timeout
  • Could not transfer artifact

原因：

1
Maven 默认使用国外中央仓库

国内访问：

1
速度非常慢

本篇文章教你：

  • Maven 配置阿里云镜像
  • settings.xml 配置
  • IDEA Maven 加速
  • .m2 仓库配置
  • Maven 下载优化

为什么 Maven 下载慢？

Maven 默认仓库：

1
Maven Central

服务器在国外。

所以：

1
国内下载依赖速度非常慢

特别是：

  • SpringBoot
  • MyBatis
  • Netty
  • Elasticsearch

大型依赖。

一、找到 .m2 文件夹

Maven 本地仓库默认位置：

Windows：

1
C:\Users\你的用户名\.m2

Mac：

1
~/.m2

Linux：

1
/root/.m2

二、新建 settings.xml

在：

1
.m2

目录下：

新建：

1
settings.xml

三、配置阿里云 Maven 镜像

将以下内容：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
<?xml version="1.0" encoding="UTF-8"?>

<settings xmlns="http://maven.apache.org/SETTINGS/1.0.0"
          xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
          xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0
          http://maven.apache.org/xsd/settings-1.0.0.xsd">

    <mirrors>

        <!-- 阿里云仓库 -->
        <mirror>
            <id>alimaven</id>
            <mirrorOf>central</mirrorOf>
            <name>aliyun maven</name>
            <url>
                https://maven.aliyun.com/repository/central
            </url>
        </mirror>

        <!-- Maven Central -->
        <mirror>
            <id>repo1</id>
            <mirrorOf>central</mirrorOf>
            <name>Maven Central</name>
            <url>
                https://repo1.maven.org/maven2/
            </url>
        </mirror>

    </mirrors>

</settings>

保存即可。

为什么推荐 HTTPS？

很多老教程：

1
还是 http

但现在：

1
很多仓库已经强制 https

否则：

1
会下载失败

所以：

1
推荐全部使用 https

四、重新加载 Maven

IDEA 中：

点击：

1
Maven

然后：

1
Reload All Maven Projects

即可重新下载依赖。

五、检查 Maven 是否生效

打开 IDEA：

1
Settings

然后：

1
Build, Execution, Deployment

↓

1
Build Tools

↓

1
Maven

查看：

1
User settings file

是否指向：

1
.m2/settings.xml

六、查看 Maven 本地仓库

默认：

1
.m2/repository

这里：

1
会缓存所有依赖

以后：

1
不用重复下载

七、删除错误缓存（推荐）

有时候：

1
依赖下载失败

会缓存：

1
.lastUpdated

导致：

1
永远下载失败

建议删除：

1
对应依赖目录

或者：

1
find . -name "*.lastUpdated" | xargs rm -f

八、推荐 Maven 配置

推荐：

配置 推荐
阿里云镜像 开启
HTTPS 必须
Maven 3.9+ 推荐
JDK 17 推荐

九、IDEA 推荐配置

IDEA：

1
不要使用 Bundled Maven

建议：

1
单独安装 Maven

然后：

1
手动指定 Maven 路径

更稳定。

Maven 推荐目录

例如：

1
D:\Java\apache-maven-3.9.6

十、常见问题

1. settings.xml 不生效

检查：

1
IDEA 是否正确指向 settings.xml

2. 依赖还是很慢

可能：

  • VPN 问题
  • DNS 问题
  • IDEA 缓存问题

3. Could not transfer artifact

通常：

1
镜像仓库失效

或者：

1
依赖不存在

4. 下载失败卡死

建议：

1
删除 .lastUpdated

然后重新下载。

十一、推荐国内 Maven 镜像

推荐：

镜像 推荐指数
阿里云 ⭐⭐⭐⭐⭐
腾讯云 ⭐⭐⭐⭐
华为云 ⭐⭐⭐⭐
Maven Central ⭐⭐⭐

阿里云仓库地址

推荐：

1
https://maven.aliyun.com/repository/central

速度：

1
国内最快之一

十二、推荐最终 settings.xml

推荐：

1
2
3
4
5
6
7
8
<mirror>
    <id>alimaven</id>
    <mirrorOf>central</mirrorOf>
    <name>aliyun maven</name>
    <url>
        https://maven.aliyun.com/repository/central
    </url>
</mirror>

已经足够。

总结

Maven 下载慢：

1
90% 都是仓库问题

解决方案：

步骤 内容
1 创建 settings.xml
2 配置阿里云镜像
3 IDEA 指向 settings.xml
4 Reload Maven

推荐：

1
HTTPS + 阿里云镜像

效果：

1
下载速度会提升非常明显

非常适合：

  • IDEA
  • SpringBoot
  • Java 后端
  • Maven 项目
  • 微服务开发