maven默认本地仓库路径为${user.home}/.m2/repository,修改方法是在%userprofile%.m2\settings.xml(windows)或~/.m2/settings.xml(linux/macos)的标签内添加绝对路径,保存后新项目即生效。

怎么改 Maven 默认本地仓库路径
默认情况下,Maven 把下载的 jar 包全扔在用户主目录下的 .m2/repository 里。如果磁盘空间小、或想统一管理多个项目的依赖,就得换地方。
改法很简单:编辑或新建 ~/.m2/settings.xml(Windows 是 %USERPROFILE%\.m2\settings.xml),在 <settings></settings> 标签下加一行:
<localRepository>/path/to/your/local/repo</localRepository>
注意:settings.xml 文件本身可能不存在,得手动创建;路径别用 ~,要用绝对路径,比如 Linux 下写 /home/you/m2-repo,Windows 下写 C:\maven\repo。
- 改完后所有新项目自动生效,但已有项目不会自动迁移旧包——要手动复制或清空重下
- IDE(如 IntelliJ)可能缓存旧路径,改完需重启或刷新 Maven 项目
- 别把本地仓库放在 NFS 或网络盘上,I/O 延迟会导致构建卡顿甚至失败
怎么让 Maven 优先从公司私服拉包
公司搭了 Nexus 或 Artifactory,但你的项目还是去中央仓库(https://repo.maven.apache.org/maven2)下载,说明私服没配进 settings.xml 的 <mirrors></mirrors> 里。
立即学习“Java免费学习笔记(深入)”;
关键不是加一个 <repository></repository> 到 pom.xml,而是全局镜像——这样连插件、父 POM 都能走私服:
<mirrors>
<mirror>
<id>company-nexus</id>
<mirrorOf>*</mirrorOf>
<url>https://nexus.example.com/repository/maven-public/</url>
</mirror>
</mirrors>
<mirrorof>*</mirrorof> 表示拦截所有仓库请求;如果只想镜像中央仓库,写 central;如果同时用多个私服,不能都设为 *,得用 external:* 或具体 ID 排除。
- 私服地址末尾的
/repository/xxx/路径必须准确,少个斜杠或写错仓库名会返回 404,但 Maven 默认只报 “Could not transfer artifact”,不提示真实 URL 错在哪 - 私服若启用了认证,必须在
settings.xml的<servers></servers>段落配好<server></server>,且<id></id>必须和<mirror></mirror>的<id></id>一致 - 某些老版本 Maven(如 3.0.x)对
mirrorOf解析有 bug,遇到奇怪的跳转失败,先升级到 3.6.3+ 再排查
为什么 mvn clean install 还是连不上私服?
常见现象:配置写了,settings.xml 也放对位置了,但执行命令时日志里还是出现 Downloading from central:,或者直接报 Connection refused。
优先检查三件事:
- 运行
mvn -X clean install(开启 debug 日志),搜Using connector和Downloading from,看实际用的是哪个mirror或repository - 确认
settings.xml真正被读取:执行mvn help:effective-settings,输出里能看到你写的localRepository和mirrors才算生效 - 检查是否被项目级
settings.xml覆盖:Maven 会按顺序加载MAVEN_HOME/conf/settings.xml→USER_HOME/.m2/settings.xml,后者优先级更高,但如果你在项目根目录放了.mvn/maven.config并指定-s参数,那就以它为准
还有一个隐蔽点:某些 CI 环境(如 Jenkins)会用自己的 settings.xml,本地配得再好也没用,得去流水线脚本里找 -s 参数或“Global Maven Configuration”设置。
私服仓库类型选 proxy 还是 hosted?
这问题不直接影响 settings.xml 配置,但关系到你拉包是否稳定、上传是否成功。Nexus 里常见的三种仓库类型中,proxy(代理远程源)、hosted(托管自有构件)、group(聚合多个仓库)必须组合使用才合理。
典型做法是:建一个 group 类型仓库(比如叫 maven-public),把它设为 mirrorOf 目标;然后把公司的 hosted(放内部 SDK)、中央仓库的 proxy(如 maven-central)、甚至 JCenter 的 proxy 全部加进这个 group。
- 只配
proxy仓库地址给开发用,会导致无法发布 SNAPSHOT 或 RELEASE 构件——因为proxy不支持写入 - 如果
settings.xml里<mirrorof></mirrorof>指向的是单个hosted仓库,那所有依赖都会 404,除非你手动把所有外部包都上传进去 - Group 仓库的顺序很重要:内部
hosted放最前,确保同名 artifact 优先取内部版本;proxy 放后面兜底
复杂点在于,不同团队可能需要隔离依赖源(比如测试环境禁用 snapshot),这时就得建多个 group,再通过不同 settings.xml 或 profile 切换——但那是另一层配置了。










