写在前面

在企业内网开发中，经常遇到这样的场景：公司有内部 Nexus 私服，你提前从私服拉取了完整的 Maven 仓库到本地，现在需要在完全离线的环境下编译项目，但 Maven 3.9.x 死活不认这个预下载的仓库。

本文记录了一次完整的踩坑与解决方案。

问题现象

多模块项目，父 POM 通过 dependencyManagement import 引用内部 BOM。执行 mvn clean install -o 时报错：

Non-resolvable import POM: common-bom:pom:2.0.0-RELEASE (absent)

即使文件存在于本地仓库，Maven 依然报错找不到。

原因分析

Maven 3.9.x 底层使用 Maven Resolver 1.9.x，引入了更严格的工件来源追踪机制。每次从远程仓库下载工件时，Resolver 会生成 _remote.repositories 文件，记录来源仓库 ID。

离线模式下，Resolver 发现 _remote.repositories 记录的仓库 ID 不在当前已知列表中，就拒绝使用本地副本。尝试过的方案均无效：删 _remote.repositories、配置 localRepository、offline=true 等。

解决方案：NTFS 目录联接

利用 Windows NTFS 目录联接（Junction），让预下载仓库出现在 Maven 默认路径下。

1. 备份现有默认仓库：

Rename-Item "$env:USERPROFILE.m2
epository" "$env:USERPROFILE.m2
epository.bak"

2. 创建目录联接（需管理员权限）：

cmd /c "mklink /J "%USERPROFILE%.m2
epository" "D:.m2qlh
epository""

3. 执行离线构建：

mvn clean install -o

备选方案

Maven 3.8.x 及以下：可用 settings.xml 配置 localRepository + offline=true，或删除所有 _remote.repositories 文件。

总结

Maven 3.9.x 的 Resolver 1.9.x 对工件来源追踪更严格，导致直接从预下载仓库离线构建失败。最终方案是利用 NTFS 目录联接（Junction）让预下载仓库出现在 Maven 默认路径下。

核心要点：备份默认仓库、创建 Junction、使用 mvn -o。不要手动修改 _remote.repositories，不要设置自定义 localRepository。

希望这篇文章帮到同样被 Maven 3.9.x 离线构建困扰的同学。