最后更新：2026-06-03
适用场景：Maven 依赖下载失败、Could not transfer artifact、Could not resolve dependencies、Transfer failed、Read timed out、Connection timed out、IDEA Maven 构建失败

使用 Maven 构建 Java 项目时，最常见的报错之一就是：

Could not transfer artifact

或者：

Could not resolve dependencies
Transfer failed for https://repo.maven.apache.org/maven2
Read timed out
Connection timed out
PKIX path building failed

很多人看到这类错误，第一反应是“依赖写错了”。但实际开发中，更多时候是下面这些问题导致的：

Maven 没有配置国内镜像
settings.xml 没有生效
IDEA 使用了另一个 Maven 配置
本地仓库缓存损坏
.lastUpdated 文件导致一直失败
公司网络需要代理
JDK / Maven 版本不匹配
依赖确实不存在或版本写错
私有仓库账号密码错误

本文整理一套完整排查流程，从 settings.xml、国内镜像、本地仓库、IDEA 配置、代理、证书、私服认证等角度解决 Maven 依赖下载失败问题。

如果你还没有配置 Maven 国内镜像，可以先看：

Maven国内镜像settings.xml配置大全：阿里云、腾讯云、华为云、清华源

一、先看报错类型

Maven 下载失败的报错很多，但大致可以分成几类。

报错关键词常见原因
Could not transfer artifact依赖下载失败，可能是网络、镜像、代理、本地缓存问题
Could not resolve dependencies依赖解析失败，可能是版本不存在、仓库缺失、缓存损坏
Transfer failed远程仓库连接失败或下载中断
Connection timed out网络连接超时
Read timed out连接上了但读取超时
PKIX path building failedHTTPS 证书校验失败
401 Unauthorized私服账号密码错误或没有权限
403 Forbidden仓库拒绝访问
404 Not Found依赖版本不存在或仓库地址不对
Non-resolvable parent POM父 POM 下载失败或仓库缺失
.lastUpdated上一次下载失败留下缓存标记

遇到 Maven 下载失败，不要盲目删除整个 .m2 仓库。更稳的顺序是：

1. 先看报错关键词
2. 检查 Maven 和 JDK 版本
3. 检查 settings.xml 是否生效
4. 检查国内镜像配置
5. 清理失败缓存
6. 强制更新依赖
7. 检查依赖坐标和仓库地址
8. 检查代理、证书、私服认证

二、先确认Maven和JDK是否正常

先在命令行执行：

mvn -version

正常输出类似：

Apache Maven 3.9.x
Maven home: D:\dev\apache-maven-3.9.x
Java version: 17.0.x
Java home: D:\Java\jdk-17

重点看这几项：

Apache Maven 版本
Maven home
Java version
Java home

Apache Maven 当前推荐的 Maven 3.9.x 版本需要 JDK 8 或以上才能运行，Maven 官方安装文档也要求系统安装 JDK，并设置 JAVA_HOME 或让 java 在 PATH 中可用。(Apache Maven)

如果这里显示的 Java 版本不对，比如项目需要 JDK17，但 mvn -version 显示 JDK8，就要先修正 JAVA_HOME。

Windows 用户可以参考：

Windows安装JDK 8 / 17 / 21 / 25完整教程：JAVA_HOME环境变量配置与验证

三、确认settings.xml到底有没有生效

Maven 的 settings.xml 通常有两个位置：

全局配置：
<Maven安装目录>/conf/settings.xml

用户配置：
~/.m2/settings.xml

Windows 示例：

D:\dev\apache-maven-3.9.16\conf\settings.xml
C:\Users\你的用户名\.m2\settings.xml

macOS / Linux 示例：

/opt/apache-maven-3.9.16/conf/settings.xml
~/.m2/settings.xml

Maven 官方文档说明，settings.xml 有全局配置和用户配置两个位置；如果两个文件都存在，会合并配置，并且用户级 settings.xml 优先。(Apache Maven)

建议优先修改：

~/.m2/settings.xml

也就是用户级配置。这样以后升级 Maven，不容易丢配置。

四、使用effective-settings查看实际配置

不要只凭感觉判断 settings.xml 生效了没有。

执行：

mvn help:effective-settings

如果你配置了阿里云 Maven 镜像，输出中应该能看到类似内容：

<mirror>
  <id>aliyunmaven</id>
  <url>https://maven.aliyun.com/repository/public</url>
  <mirrorOf>*</mirrorOf>
</mirror>

如果看不到你配置的 mirror，说明 Maven 没有读取你修改的 settings.xml。

常见原因：

1. 修改的是全局 settings.xml，但命令行使用的是另一个 Maven
2. 修改的是用户 settings.xml，但文件路径不对
3. IDEA 使用了独立的 User settings file
4. settings.xml XML 格式写错
5. 文件名写成了 setting.xml 或 settings.xml.txt

五、配置一个可用的国内镜像

普通开发者可以先使用阿里云 Maven 镜像。

~/.m2/settings.xml 示例：

<?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 https://maven.apache.org/xsd/settings-1.0.0.xsd">

    <localRepository>${user.home}/.m2/repository</localRepository>

    <mirrors>
        <mirror>
            <id>aliyunmaven</id>
            <name>阿里云公共仓库</name>
            <url>https://maven.aliyun.com/repository/public</url>
            <mirrorOf>*</mirrorOf>
        </mirror>
    </mirrors>

</settings>

Maven 官方文档中，localRepository 默认值是 ${user.home}/.m2/repository，也就是用户目录下的 .m2/repository。(Apache Maven)

如果你在腾讯云服务器上，可以换成腾讯云：

<mirror>
    <id>nexus-tencentyun</id>
    <name>Nexus tencentyun</name>
    <url>https://mirrors.tencent.com/nexus/repository/maven-public/</url>
    <mirrorOf>*</mirrorOf>
</mirror>

如果你在华为云服务器上，可以换成华为云：

<mirror>
    <id>huaweicloud</id>
    <name>华为云 Maven 镜像</name>
    <url>https://repo.huaweicloud.com/repository/maven/</url>
    <mirrorOf>*</mirrorOf>
</mirror>

更完整的镜像配置可以看：

Maven国内镜像settings.xml配置大全：阿里云、腾讯云、华为云、清华源

六、不要同时配置多个mirrorOf="*"

很多人为了“保险”，会这样写：

<mirrors>
    <mirror>
        <id>aliyunmaven</id>
        <url>https://maven.aliyun.com/repository/public</url>
        <mirrorOf>*</mirrorOf>
    </mirror>

    <mirror>
        <id>huaweicloud</id>
        <url>https://repo.huaweicloud.com/repository/maven/</url>
        <mirrorOf>*</mirrorOf>
    </mirror>

    <mirror>
        <id>tencent</id>
        <url>https://mirrors.tencent.com/nexus/repository/maven-public/</url>
        <mirrorOf>*</mirrorOf>
    </mirror>
</mirrors>

这个写法看起来像“多个镜像备用”，但 Maven 不是这样工作的。

Maven 官方镜像文档说明，对于一个仓库最多只能有一个 mirror；如果多个 mirror 匹配同一个仓库，Maven 不会聚合这些 mirror，而是选择第一个匹配项。(Apache Maven)

所以正确做法是：

只保留一个主镜像

例如只用阿里云：

<mirrors>
    <mirror>
        <id>aliyunmaven</id>
        <name>阿里云公共仓库</name>
        <url>https://maven.aliyun.com/repository/public</url>
        <mirrorOf>*</mirrorOf>
    </mirror>
</mirrors>

如果这个镜像暂时不可用，再手动切换到腾讯云或华为云。

七、mirrorOf写central还是*？

常见写法有两种：

<mirrorOf>central</mirrorOf>

和：

<mirrorOf>*</mirrorOf>

区别如下：

写法含义适合场景
central只代理 Maven Central项目还要访问其他特殊仓库
*代理所有远程仓库请求普通个人开发环境
external:*代理外部仓库，不代理本地和 file 仓库企业项目、复杂项目
*,!repo-id代理除某个仓库之外的所有仓库需要排除公司私服或特殊仓库

Maven 官方文档说明，如果想强制 Maven 使用一个单一仓库，可以将 mirrorOf 设置为 *；高级写法中，* 匹配所有仓库，external:* 匹配外部仓库，也支持用 ! 排除某个仓库 ID。(Apache Maven)

个人电脑可以先用：

<mirrorOf>*</mirrorOf>

公司项目如果有私服，不要乱配。更推荐让公司 Nexus / Artifactory 统一代理外部仓库。

八、强制更新依赖

如果镜像已经配置好，但依赖还是下载失败，可以先执行：

mvn clean package -U

-U 的作用是强制检查远程依赖更新，适合排查本地缓存导致的问题。

也可以执行：

mvn clean install -U

如果只是想下载依赖，不想完整打包，可以执行：

mvn dependency:resolve -U

如果是插件下载失败，也可以试：

mvn clean package -U -X

其中：

-U：强制更新依赖
-X：输出 Debug 日志

九、清理.lastUpdated失败缓存

Maven 下载依赖失败后，经常会在本地仓库留下 .lastUpdated 文件。

这些文件可能导致 Maven 后续一段时间不再重新下载，表现就是你明明修好了镜像，但还是一直报同样的错误。

Linux / macOS 清理命令：

find ~/.m2/repository -name "*.lastUpdated" -delete

Windows PowerShell：

Get-ChildItem "$env:USERPROFILE\.m2\repository" -Recurse -Filter "*.lastUpdated" | Remove-Item

然后重新执行：

mvn clean package -U

如果你不放心一次性删全部，可以只删除某个依赖目录下的 .lastUpdated 文件。

十、删除指定依赖缓存

如果只有某个依赖下载失败，不要动不动删除整个 .m2/repository。

例如报错中出现：

com.example:demo-sdk:1.0.0

可以只删除：

~/.m2/repository/com/example/demo-sdk/1.0.0

Linux / macOS：

rm -rf ~/.m2/repository/com/example/demo-sdk/1.0.0

Windows：

C:\Users\你的用户名\.m2\repository\com\example\demo-sdk\1.0.0

删除后执行：

mvn clean package -U

十一、使用dependency:purge-local-repository清理依赖

如果你怀疑本地仓库中多个依赖缓存损坏，可以使用 Maven Dependency Plugin 的：

mvn dependency:purge-local-repository

Maven Dependency Plugin 官方文档说明，dependency:purge-local-repository 会从本地仓库移除项目依赖，并且可以重新解析依赖；默认情况下，清理后会重新解析下载。(Apache Maven)

常用命令：

mvn dependency:purge-local-repository

只清理某个依赖：

mvn dependency:purge-local-repository -DmanualInclude=com.example:demo-sdk

清理后不立即重新下载：

mvn dependency:purge-local-repository -DreResolve=false

然后再执行：

mvn clean package -U

注意：这个命令会清理当前项目依赖相关的本地缓存。对大型项目来说，重新下载可能比较慢。

十二、检查依赖坐标是否写错

有时候不是网络问题，而是依赖本身写错了。

例如：

<dependency>
    <groupId>com.fasterxml.jackson.core</groupId>
    <artifactId>jackson-databindd</artifactId>
    <version>2.17.0</version>
</dependency>

这里 jackson-databindd 多了一个 d，肯定下载不到。

正确：

<dependency>
    <groupId>com.fasterxml.jackson.core</groupId>
    <artifactId>jackson-databind</artifactId>
    <version>2.17.0</version>
</dependency>

排查时重点看：

groupId 是否正确
artifactId 是否正确
version 是否存在
是否拼错
是否使用了公司私有依赖
是否依赖只存在于特殊仓库

如果是开源依赖，可以去 Maven Central 或 mvnrepository 搜索确认坐标是否存在。

十三、检查是否缺少特殊仓库

并不是所有依赖都在 Maven Central。

有些依赖可能需要特殊仓库，例如：

公司 Nexus 私服
Spring Milestone / Snapshot 仓库
Sonatype Snapshot 仓库
第三方厂商仓库
历史老仓库

如果报错中出现：

Could not find artifact xxx in central

可能说明这个依赖根本不在 Maven Central。

这时需要在 pom.xml 或公司私服里配置对应仓库。

示例：

<repositories>
    <repository>
        <id>company-nexus</id>
        <name>Company Nexus</name>
        <url>https://nexus.example.com/repository/maven-public/</url>
    </repository>
</repositories>

但公司项目更推荐在 settings.xml 中通过公司私服统一代理，而不是每个项目都乱写仓库地址。

十四、检查SNAPSHOT依赖

如果你依赖的是：

1.0.0-SNAPSHOT

需要确认仓库是否允许下载 snapshot。

示例：

<repository>
    <id>company-snapshots</id>
    <url>https://nexus.example.com/repository/maven-snapshots/</url>
    <snapshots>
        <enabled>true</enabled>
    </snapshots>
    <releases>
        <enabled>false</enabled>
    </releases>
</repository>

常见错误：

1. SNAPSHOT 依赖被配置到了 releases 仓库
2. releases 仓库禁用了 snapshots
3. snapshots 仓库没配置
4. 公司私服没有同步对应版本
5. 本地缓存了旧的 snapshot 元数据

可以执行：

mvn clean package -U

强制检查更新。

十五、IDEA中Maven配置也要检查

很多时候命令行 Maven 正常，但 IDEA 里还是报：

Could not transfer artifact

这是因为 IDEA 可能使用了另一个 Maven 或另一个 settings.xml。

在 IntelliJ IDEA 中检查：

File > Settings > Build, Execution, Deployment > Build Tools > Maven

macOS：

IntelliJ IDEA > Settings > Build, Execution, Deployment > Build Tools > Maven

重点看：

Maven home path
User settings file
Local repository

推荐：

Maven home path：
选择你本地安装的 Maven，例如 D:\dev\apache-maven-3.9.16

User settings file：
选择 C:\Users\你的用户名\.m2\settings.xml

Local repository：
选择 C:\Users\你的用户名\.m2\repository

还要检查：

File > Settings > Build Tools > Maven > Runner > JRE

如果 Maven Runner JRE 选错了 JDK，也可能导致插件或编译阶段报错。

IDEA 配置 JDK 可以看：

IDEA下载JDK很慢怎么办？手动配置本地JDK完整教程

十六、检查IDEA是否开启了Offline模式

如果 IDEA 开启了 Maven 离线模式，即使网络正常，Maven 也不会去远程仓库下载依赖。

检查：

Maven 工具窗口 > Toggle Offline Mode

或者在设置中检查 Maven 是否启用了离线模式。

命令行中也不要加：

-o

例如下面这个命令就是离线构建：

mvn clean package -o

离线模式下，如果本地仓库没有依赖，就会报依赖找不到。

十七、公司网络需要代理怎么办？

如果你在公司内网，访问外部 Maven 仓库可能需要代理。

可以在 settings.xml 中配置：

<proxies>
    <proxy>
        <id>company-proxy</id>
        <active>true</active>
        <protocol>http</protocol>
        <host>proxy.example.com</host>
        <port>8080</port>
        <username>your_username</username>
        <password>your_password</password>
        <nonProxyHosts>localhost|127.0.0.1|*.example.com</nonProxyHosts>
    </proxy>
</proxies>

Maven 官方 settings.xml 文档中，proxies 用于配置代理，包括协议、主机、端口、账号密码和不走代理的主机列表。(Apache Maven)

注意：

1. 账号密码不要提交到代码仓库
2. 公司私服地址通常应放到 nonProxyHosts
3. 只有一个 proxy 应该 active=true
4. HTTP 和 HTTPS 代理要根据公司网络实际情况配置

十八、PKIX path building failed怎么解决？

如果报错：

PKIX path building failed
unable to find valid certification path to requested target

这是证书校验失败。

常见原因：

公司 HTTPS 代理替换了证书
JDK 证书库缺少公司根证书
使用了过旧 JDK
仓库证书链异常
抓包工具代理了 HTTPS

解决方向：

1. 换网络测试，确认是不是公司网络问题
2. 升级 JDK
3. 让运维提供公司根证书
4. 将公司根证书导入当前 JDK 的 cacerts
5. 检查 IDEA 和命令行使用的是不是同一个 JDK

导入证书示例：

keytool -importcert \
  -alias company-root-ca \
  -file company-root-ca.crt \
  -keystore "%JAVA_HOME%/lib/security/cacerts" \
  -storepass changeit

注意：导入证书前先确认来源可信，不要随便导入不明证书。

十九、私服401或403怎么解决？

如果报错：

401 Unauthorized

通常是账号密码错误或没有权限。

如果报错：

403 Forbidden

通常是账号没有访问权限，或者仓库禁止下载。

在 settings.xml 中配置：

<servers>
    <server>
        <id>company-nexus</id>
        <username>your_username</username>
        <password>your_password_or_token</password>
    </server>
</servers>

注意：server 的 id 必须和仓库或 mirror 的 id 对应。

例如 mirror 是：

<mirror>
    <id>company-nexus</id>
    <url>https://nexus.example.com/repository/maven-public/</url>
    <mirrorOf>*</mirrorOf>
</mirror>

那么 server 也要写：

<server>
    <id>company-nexus</id>
    <username>your_username</username>
    <password>your_password_or_token</password>
</server>

Maven 官方 settings.xml 文档也说明，servers.server.id 用于匹配 Maven 连接的 repository 或 mirror 的 id。(Apache Maven)

二十、parent POM下载失败怎么办？

常见报错：

Non-resolvable parent POM
Could not find artifact com.example:parent:pom:1.0.0

常见原因：

父POM没有发布到仓库
父POM版本写错
relativePath 配置错误
公司私服没有权限
本地缓存损坏

如果父 POM 在同一个多模块项目里，检查：

<parent>
    <groupId>com.example</groupId>
    <artifactId>parent</artifactId>
    <version>1.0.0</version>
    <relativePath>../pom.xml</relativePath>
</parent>

如果父 POM 在远程仓库里，检查：

1. groupId / artifactId / version 是否正确
2. 私服是否有该父 POM
3. settings.xml 是否配置了私服
4. 账号密码是否正确
5. 本地缓存是否损坏

可以删除父 POM 本地缓存后重新下载：

rm -rf ~/.m2/repository/com/example/parent/1.0.0
mvn clean package -U

Windows 手动删除：

C:\Users\你的用户名\.m2\repository\com\example\parent\1.0.0

二十一、插件下载失败怎么办？

Maven 插件也需要从仓库下载，例如：

maven-compiler-plugin
maven-surefire-plugin
spring-boot-maven-plugin
maven-dependency-plugin

如果报错：

Plugin could not be resolved
Plugin org.apache.maven.plugins:maven-compiler-plugin not found

排查：

1. settings.xml 镜像是否生效
2. 公司私服是否代理了插件仓库
3. Maven 是否离线
4. 插件版本是否写错
5. 本地插件缓存是否损坏

可以删除对应插件缓存：

rm -rf ~/.m2/repository/org/apache/maven/plugins/maven-compiler-plugin

然后：

mvn clean package -U

二十二、打开Debug日志看真实原因

如果普通日志看不出来，执行：

mvn clean package -X

或者：

mvn dependency:resolve -X

重点搜索这些关键词：

Using mirror
Downloading from
Downloaded from
Could not transfer artifact
Caused by
Return code is
PKIX
401
403
404

如果看到：

Using mirror aliyunmaven

说明镜像生效了。

如果还是看到：

Downloading from central: https://repo.maven.apache.org/maven2

说明你的镜像可能没有匹配到，或者 settings.xml 没有生效。

二十三、不要轻易删除整个.m2仓库

很多教程会让你直接删除：

~/.m2/repository

这确实有时能解决问题，但不建议一上来就这么做。

缺点：

1. 所有依赖都要重新下载
2. 项目多时非常慢
3. 公司内网环境可能重新下载失败
4. CI/CD 或老项目依赖可能更难恢复

更建议按顺序：

1. 删除 .lastUpdated
2. 删除具体依赖目录
3. 使用 dependency:purge-local-repository
4. 最后才考虑清空整个本地仓库

如果本地仓库已经非常混乱，最后手段可以是：

rm -rf ~/.m2/repository
mvn clean package -U

Windows 可以手动删除：

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

二十四、完整排查流程

遇到 Could not transfer artifact，按下面顺序来：

1. 执行 mvn -version，确认 Maven 和 JDK
2. 执行 mvn help:effective-settings，确认 settings.xml 生效
3. 检查 settings.xml 是否配置国内镜像
4. 确认不要有多个 mirrorOf="*"
5. 执行 mvn clean package -U
6. 删除 .lastUpdated 文件
7. 删除具体失败依赖目录
8. 检查依赖 groupId / artifactId / version
9. 检查是否需要特殊仓库或公司私服
10. 检查 SNAPSHOT 仓库配置
11. 检查 IDEA Maven home / User settings file / Local repository
12. 检查 Maven Offline Mode
13. 检查公司代理 proxies
14. 检查证书 PKIX 问题
15. 检查私服账号密码和权限
16. 使用 mvn -X 查看真实下载地址和失败原因

二十五、常见问题FAQ

1. Could not transfer artifact 一定是镜像问题吗？

不一定。

可能是：

网络问题
镜像问题
本地缓存损坏
依赖版本不存在
私服权限问题
代理问题
证书问题
settings.xml 没生效

所以要按流程排查，不要只改镜像。

2. 配置了国内镜像，为什么还是访问 Maven Central？

先执行：

mvn help:effective-settings

看 mirror 是否存在。

再执行：

mvn clean package -X

看日志里是否有：

Using mirror

如果没有，说明 settings.xml 没生效或 mirrorOf 没匹配到。

3. 能不能同时配置阿里云、腾讯云、华为云三个镜像？

不建议同时配置多个 mirrorOf="*"。

Maven 对同一个仓库不会聚合多个 mirror，而是选择第一个匹配项。(Apache Maven)

建议：

个人电脑选一个稳定镜像
公司项目使用公司 Nexus / Artifactory

4. 删除.lastUpdated安全吗？

一般可以删除。

.lastUpdated 是 Maven 下载失败后留下的状态文件。删除后，Maven 会在下次构建时重新尝试下载。

建议先删 .lastUpdated，不要一上来删除整个 .m2/repository。

5. Maven本地仓库可以换路径吗？

可以。

在 settings.xml 中配置：

<localRepository>D:/dev/maven/repository</localRepository>

但路径建议简单，不要包含中文、空格和特殊符号。

6. IDEA里Maven下载失败，命令行正常怎么办？

通常是 IDEA Maven 配置和命令行不一致。

检查：

Maven home path
User settings file
Local repository
Runner JRE
Offline mode

然后点击：

Reload All Maven Projects

7. 命令行下载失败，IDEA正常怎么办？

可能是 IDEA 使用了自己的 Maven 或自己的 settings.xml。

命令行检查：

mvn -version
mvn help:effective-settings

IDEA 检查：

Settings > Build Tools > Maven

对比两个环境是否一致。

8. 401 Unauthorized 怎么办？

检查 settings.xml 里的：

<servers>
    <server>
        <id>仓库ID</id>
        <username>用户名</username>
        <password>密码或Token</password>
    </server>
</servers>

server.id 要和 repository 或 mirror 的 id 对应。

9. 404 Not Found 是什么问题？

常见原因：

依赖版本不存在
仓库里没有这个依赖
artifactId 拼错
groupId 拼错
SNAPSHOT / RELEASE 仓库用错
私有依赖没有发布

先确认依赖坐标是否真实存在。

10. PKIX path building failed 是不是 Maven 问题？

通常不是 Maven 本身的问题，而是 HTTPS 证书链问题。

重点检查：

公司代理
JDK证书库
抓包工具
仓库证书
IDEA和命令行使用的JDK是否一致

二十六、最终推荐配置

普通个人开发环境，建议 ~/.m2/settings.xml 先用这一份：

<?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 https://maven.apache.org/xsd/settings-1.0.0.xsd">

    <localRepository>${user.home}/.m2/repository</localRepository>

    <mirrors>
        <mirror>
            <id>aliyunmaven</id>
            <name>阿里云公共仓库</name>
            <url>https://maven.aliyun.com/repository/public</url>
            <mirrorOf>*</mirrorOf>
        </mirror>
    </mirrors>

</settings>

验证：

mvn -version
mvn help:effective-settings
mvn clean package -U

如果失败，按本文排查清单一步一步查，不要一上来就删除整个本地仓库。

二十七、相关文章

Maven 国内镜像配置可以看：

Maven国内镜像settings.xml配置大全：阿里云、腾讯云、华为云、清华源

JDK 还没安装可以看：

各版本JDK镜像下载地址：JDK8 / JDK11 / JDK17 / JDK21 / JDK25 / JDK26 下载与IDEA配置指南

Windows 配置 JDK 和 JAVA_HOME 可以看：

Windows安装JDK 8 / 17 / 21 / 25完整教程：JAVA_HOME环境变量配置与验证

IDEA 中配置 JDK 可以看：

IDEA下载JDK很慢怎么办？手动配置本地JDK完整教程

如果遇到 JDK 版本不兼容，可以看：

Java版本号与class文件major version对照表：Unsupported class file major version 52 / 55 / 61 / 65 / 69 / 70

完整 Java 环境配置可以看：

Java开发环境配置专题：JDK、IDEA、Maven、Gradle、版本兼容与常见报错

更新记录

2026-06-03：
- 增加 Maven Could not transfer artifact 完整排查流程
- 增加 settings.xml 是否生效检查方法
- 增加国内镜像 mirrorOf 配置说明
- 增加 .lastUpdated 清理方法
- 增加 dependency:purge-local-repository 清理本地仓库方法
- 增加 IDEA Maven 配置排查
- 增加代理、证书、私服认证、SNAPSHOT、parent POM 常见问题
- 增加 Maven 下载失败 FAQ