本文详解 maven 在 windows 环境中因误用 install:install-file 导致子模块依赖无法解析父 pom 的根本原因，并提供符合 maven 标准流程的解决方案——避免手动管理本地仓库路径，转而正确利用默认 .m2 本地仓库机制。
本文详解 maven 在 windows 环境中因误用 install:install-file 导致子模块依赖无法解析父 pom 的根本原因，并提供符合 maven 标准流程的解决方案——避免手动管理本地仓库路径，转而正确利用默认 .m2 本地仓库机制。
在 Windows 系统中，Maven 默认将构建产物（包括父 POM 和子模块）自动安装至用户主目录下的本地仓库：C:\Users\<用户名>\.m2\repository。这是 Maven 依赖解析的核心信任源，所有 mvn install 命令（无论在哪个模块执行）均默认写入此位置，且后续构建也默认从此处读取依赖。
问题根源在于：您在 demo 项目中通过 mvn install:install-file 将 math-util-1.0-SNAPSHOT.jar 手动安装到自定义路径 ./lib，并配置 <repository><url>file://${project.basedir}/lib</url></repository>。这看似“可控”，实则破坏了 Maven 的依赖传递链：
- math-util-1.0-SNAPSHOT.jar 的 pom.xml（由 install-file 自动生成）明确声明了 <parent>：
<parent> <groupId>com.javi</groupId> <artifactId>parent-util</artifactId> <version>1.0-SNAPSHOT</version> </parent>
- 当 Maven 解析 math-util 时，会递归查找其父 POM com.javi:parent-util:pom:1.0-SNAPSHOT；
- 但该父 POM 并未被安装到 ./lib 目录中（install-file 只处理指定 JAR，不处理其依赖或 parent）；
- Windows 的 file:// 协议对路径解析更严格（如反斜杠、空格、编码等），导致即使尝试补全父 POM 也无法被可靠识别；
- 而 Ubuntu/macOS 对 file:// 路径容忍度更高，故“偶然”成功，但这属于平台差异掩盖的错误实践。
✅ 正确做法：回归 Maven 标准生命周期，杜绝手动 install-file
-
在 parent-util 根目录下执行一次完整安装：
cd /path/to/parent-util mvn clean install
✅ 此命令会：
- 先安装 parent-util-1.0-SNAPSHOT.pom 到 ~/.m2/repository/com/javi/parent-util/1.0-SNAPSHOT/
- 再安装 math-util-1.0-SNAPSHOT.jar 及其 pom.xml（含正确 <parent> 引用）到对应路径；
- 确保父子关系在本地仓库中完整、可追溯。
-
删除 demo 项目中所有自定义仓库配置：
<!-- 删除整个 <repositories> 块 --> <!-- 不再需要 file:// 指向 ./lib -->
-
demo/pom.xml 仅保留标准依赖声明：
<dependencies> <dependency> <groupId>com.javi</groupId> <artifactId>math-util</artifactId> <version>1.0-SNAPSHOT</version> </dependency> </dependencies>Maven 会自动从 ~/.m2/repository 中解析 math-util，并顺藤摸瓜找到已安装的 parent-util。
-
验证与清理（Windows 特别注意）：
- 确保 demo 项目未启用 IDE（如 IDEA）的“离线模式”；
- 若之前失败缓存干扰，可执行：
mvn clean compile -U # -U 强制更新快照依赖
- 如仍报错，检查 ~/.m2/repository/com/javi/ 下是否存在 parent-util/1.0-SNAPSHOT/parent-util-1.0-SNAPSHOT.pom —— 若缺失，说明 parent-util 未成功 install。
⚠️ 关键注意事项：
- 永远不要为多模块项目中的子模块单独使用 install:install-file：它绕过 Maven 的模块化构建逻辑，割裂 parent-child 关系；
- <relativePath> 仅在父 POM 与当前 POM 处于物理邻近目录时生效（如 ../pom.xml），对已安装到 .m2 的 snapshot 无效；
- Windows 路径中的空格或中文用户名可能导致 file:// 协议解析异常，而 ~/.m2 是 Maven 经过充分测试的安全路径；
- 若需分发 math-util 给外部团队，应发布至 Nexus/Artifactory 等远程仓库，而非提供 JAR 文件——这才是企业级依赖管理的正道。
遵循上述流程后，mvn clean install 在 demo 项目中将稳定通过，且跨平台行为一致。Maven 的强大，正源于其约定优于配置的设计哲学——尊重默认，方得始终。
