Maven - tag - 沐木https://oldletter.cn/tags/maven/Maven - tag - 沐木Hugo -- gohugo.iozh-cnWed, 24 Nov 2021 00:00:00 +0000Maven 国内源配置指南（2026 版）https://oldletter.cn/posts/java-02-maven/Wed, 24 Nov 2021 00:00:00 +0000mumuhttps://oldletter.cn/posts/java-02-maven/

📅 2026-05-15 | 🏷️ Maven, Gradle, 信创, DevOps | 📖 阅读约 12 分钟

前言

“Could not resolve dependencies”，这大概是每个 Java 开发者在国内网络环境下更不想看到的错误。

Maven Central 在国内访问速度慢、不稳定，尤其在企业内网和信创环境下，配置国内镜像源几乎是项目初始化的第一步。但你真的会配吗？镜像优先级怎么算？私服和镜像怎么共存？Gradle 的配置和 Maven 有什么不同？

这篇文章给你一个完整的、可直接复制粘贴的配置方案，覆盖 Maven、Gradle、私服、代理、信创环境，2026 年当前公开版。

一、为什么需要国内镜像

Maven Central（https://repo.maven.apache.org/maven2）物理上在美国，国内访问存在以下问题：

  1. 延迟高：HTTPS 握手 + TCP 往返，单次请求 500ms-2s
  2. 不稳定：国际链路抖动，下载大文件容易中断
  3. 带宽受限：高峰期下载速度可能只有几十 KB/s
  4. 安全合规：信创/政企环境不允许直接访问外网

国内镜像源同步了 Maven Central 的所有包，物理上在国内，访问速度提升 10-100 倍。

Maven 依赖解析机制

Maven 的依赖解析遵循下限路径优先原则。当同一个依赖存在多个版本时，Maven 会在依赖树中选择深度更浅（路径下限）的那个版本。如果深度相同，则按 POM 中声明的顺序选择第一个。

形式化地说，对于依赖树中的节点 D，其解析版本为所有候选版本中深度下限的那个。因此直接声明的依赖优先级高于传递依赖。

二、Maven 配置

2.1 settings.xml 完整配置

将以下内容保存到 ~/.m2/settings.xml（全局配置）或 $MAVEN_HOME/conf/settings.xml（安装级别）：

]]>