夜雨聆风
做Java开发的小伙伴，几乎都遇到过这样的崩溃场景：
启动项目时，控制台突然报错，提示“依赖failed to transfer”“Connect timed out”，明明依赖坐标没错，却怎么都下载不下来，提示连接 repo.maven.apache.org 超时，且失败被缓存，无法重新尝试。
其实这类问题不是个例，本质都是「网络超时」+「Maven失败缓存」导致的，不管任何Maven依赖，都能套用下面的通用解决方案，一次性根治！
一、问题核心原因（先搞懂，再解决）
很多人遇到依赖下载失败，第一反应是“坐标写错了”，但大部分时候，问题出在两点：
网络超时：Maven默认的中央仓库（https://repo.maven.apache.org/maven2）部署在国外，国内网络直接访问，很容易出现连接超时、下载速度为0的情况； 缓存未清理：Maven会缓存下载失败的记录，一旦某次下载超时，后续会直接沿用这个失败缓存，不会自动重新尝试下载。
搞懂这两个原因，解决起来就很简单了——先解决网络问题，再清理缓存，两步到位！
二、通用解决方案（3步走，所有依赖都适用）
第一步：配置国内镜像（永久解决网络超时）
这是最核心的一步，把Maven默认的国外仓库，替换成国内阿里云镜像，下载速度会从“龟速”变“秒速”，彻底避免超时问题。
操作步骤（超详细，新手也能看懂）：
找到Maven的配置文件
settings.xml，有两个存放位置，任选其一即可：用户级（推荐，不影响其他项目）：C:\Users\你的用户名\.m2\settings.xml（比如C:\Users\Admin\.m2\settings.xml）； 全局级（影响所有使用该Maven的项目）：Maven安装目录\conf\settings.xml（比如D:\apache-maven-3.8.8\conf\settings.xml）。 打开settings.xml文件，找到
<mirrors>标签（如果没有，就手动在<settings>标签内添加）；将
<mirrors>标签内的内容，替换为以下阿里云镜像配置（直接复制粘贴即可）：
<mirrors> <!-- 阿里云Maven镜像，替代默认中央仓库，国内首选 --> <mirror> <id>aliyunmaven</id> <mirrorOf>central</mirrorOf> <url>https://maven.aliyun.com/repository/public</url> </mirror> <!-- 备选镜像，防止阿里云镜像临时不可用 --> <mirror> <id>huaweicloud</id> <mirrorOf>central</mirrorOf> <url>https://mirrors.huaweicloud.com/repository/maven/</url> </mirror></mirrors>保存文件，镜像配置就完成了，后续所有依赖都会从国内镜像下载。
第二步：强制更新依赖（清除失败缓存）
配置好镜像后，需要强制Maven忽略之前的失败缓存，重新下载依赖，操作很简单：
打开终端（Windows用CMD或PowerShell，Mac/Linux用终端）； 进入你的Java项目根目录（就是包含pom.xml文件的目录）； 执行以下命令（复制粘贴，直接运行）：
mvncleancompile-U重点说明：
clean：清理项目编译后的临时文件，避免缓存干扰；compile：编译项目，触发依赖下载；-U：关键参数，强制Maven更新依赖，忽略之前的失败缓存，重新从镜像下载。
运行命令后，耐心等待片刻，依赖就能成功下载，控制台不会再报超时错误。
第三步：兜底方案（手动清理缓存，万无一失）
如果执行第二步后，还是报错，大概率是本地缓存的失败文件没有被彻底清理，手动删除即可：
打开本地Maven仓库（默认路径：C:\Users\你的用户名\.m2\repository）； 根据报错的依赖坐标，找到对应的文件夹。比如报错“org.yaml:snakeyaml:jar:2.3”，就进入 org/yaml/snakeyaml目录；删除该目录下的 2.3文件夹（这个文件夹就是缓存的失败依赖）；重新执行第二步的命令（mvn clean compile -U），依赖就能正常下载了。
提示：不管是哪个依赖下载失败，都可以按照这个逻辑，找到对应的依赖文件夹删除，再重新执行命令。
三、总结
Maven依赖下载失败，根本不用慌，记住核心逻辑：
网络超时 → 配置国内镜像；缓存失败 → 强制更新/手动删除缓存
按照上面的3步操作，任何Maven依赖的下载问题，都能一次性解决。
