Maven依赖拉不下来

编译时报Could not resolve dependencies或Could not transfer artifact多数不是代码问题而是网络、镜像或本地缓存的事。这篇按四类走一遍每步给判断命令。适用范围JDK 17 Maven 3.9国内网络环境。一、先看清失败的是哪个坐标mvn-Uclean package-e-e会把完整异常打出来先确认到底卡在哪个groupId:artifactId上再往下排查。二、四类原因与改法1. 网络或代理拦截判断curl-Ihttps://repo.maven.apache.org/maven2/不通或超时说明直连官方仓库被拦公司网络、中间代理很常见。改法在~/.m2/settings.xml配镜像见下一条。2. 镜像配置没生效或覆盖范围不对改法mirrorsmirroridaliyun/idmirrorOfcentral/mirrorOfurlhttps://maven.aliyun.com/repository/public/url/mirror/mirrors说明mirrorOf写central表示所有对 central 的请求都走镜像如果写成*又漏配了别的仓库反而会出现某些包找不到。3. 本地缓存里的失败标记现象换完镜像还是拉不下来。改法清掉失败标记再拉find~/.m2/repository-name*.lastUpdated-deletemvn-Uclean package说明Maven 会把下载失败记成*.lastUpdated短期内不再重试-U是强制更新快照与元数据。4. 坐标或版本写错现象Could not find artifact。判断把groupId / artifactId / version拿去中央仓库搜一下确认真实存在别凭记忆写。三、mirrorOf写法对照最容易配错的一行写法含义适用场景central只代理 central 仓库只让官方库走镜像其他照原样*代理全部仓库内网统一出口漏配其他仓库会报找不到包central,!repos除repos私服外都走镜像同时有自建私服时说明mirrorOf写错是依赖拉不下来里最隐蔽的一类——命令、网络都正常就是某个包反复 404。先确认你的mirrorOf覆盖范围再怀疑网络。常见报错文案对照报错文案大概率原因Connection timed out/Unknown host网络不通或代理拦截Could not find artifact坐标写错或镜像覆盖范围不对was cached in the local repository缓存里的失败标记没清四、固定排查顺序网络能不能通 → 镜像有没有生效 → 缓存要不要清 → 坐标对不对。前面一步不通过就不用往后走。五、踩坑记录我以为是版本冲突实际是公司网络拦了官方仓库——换镜像后一次就过了。六、收尾依赖问题看着杂其实就这四类。按上面的顺序走绝大多数情况能在几分钟内定位。本文由 AI 辅助整理框架与措辞技术要点与命令均经本人实测核对。如果卡在同样的问题上可以留言说清报错和版本我按技术问题帮你判断。