本文详解 Maven 多模块项目的标准构建流程，指出直接单独执行子模块 mvn install 易导致依赖解析失败，并强调必须从父 POM 目录统一执行 mvn install，以利用 Maven 的构建反应器（reactor）机制自动解析模块间依赖。
本文详解 maven 多模块项目的标准构建流程，指出直接单独执行子模块 `mvn install` 易导致依赖解析失败，并强调必须从父 pom 目录统一执行 `mvn install`，以利用 maven 的构建反应器（reactor）机制自动解析模块间依赖。
在 Maven 中，当多个项目存在强依赖关系（如项目 B 依赖项目 A 的 JAR），且二者同属一个逻辑产品体系时，不应将它们视为独立项目分别构建，而应组织为标准的多模块（multi-module）Maven 项目。您提供的 parent pom.xml 已明确定义了 <modules> 结构，并将 entera-demo-design-1-00 和 entera-demo-design-1-01 声明为子模块——这正是 Maven 多模块项目的典型特征。
✅ 正确做法：统一从父项目根目录构建
Maven 通过 构建反应器（Build Reactor） 自动分析模块拓扑、计算编译顺序，并在内存中直接传递模块产物（无需写入/读取本地仓库 .m2），从而避免版本不一致、元数据缺失或路径错配等问题。因此：
-
切换到父 POM 所在目录（即包含 pom.xml 且含 <modules> 声明的目录）：
cd /path/to/entera-demo-design # 确保该目录下有 parent pom.xml
-
执行统一构建命令：
mvn install
⚠️ 注意：mvn compile package install 是冗余的。Maven 生命周期具有阶段串行性：install 阶段天然包含 validate → compile → package → install 全流程。重复声明不仅无益，还易引发理解偏差。
执行后，Maven 将按依赖顺序（例如先构建 entera-demo-design-1-00，再构建依赖它的 entera-demo-design-1-01）完成全部模块的编译、打包与安装。此时 entera-demo-design-1-01 能无缝引用 entera-demo-design-1-00 的类，无需任何额外配置。
❌ 常见错误与原因分析
您遇到的报错：
Could not find artifact org.entera:entera-demo-design:pom:1.0-SNAPSHOT
根本原因在于：
- 您可能在 entera-demo-design-1-01 子目录下单独运行了 mvn install；
- 此时 Maven 无法识别父模块上下文，于是尝试从本地仓库（.m2/repository）解析 org.entera:entera-demo-design-1-00:1.0-SNAPSHOT；
- 但 pom.xml 中 <parent> 声明的 artifactId 是 entera-demo-design（聚合模块），而子模块 JAR 的坐标是 org.entera:entera-demo-design-1-00:1.0-SNAPSHOT —— 两者不同，且 parent 的 POM 本身未被安装（仅子模块 JAR 被装），导致元数据链断裂。
此外，观察您的本地仓库结构：
~/.m2/repository/org/entera/entera-demo-design-1-00/1.0-SNAPSHOT/ ├── entera-demo-design-1-00-1.0-SNAPSHOT.jar ├── entera-demo-design-1-00-1.0-SNAPSHOT.pom ← 关键！此文件必须存在且内容正确
若该 pom.xml 文件缺失或未正确定义其 groupId/artifactId/version，即使手动安装也会失败。而通过 reactor 构建可完全规避此风险。
? 进阶提示：选择性构建与调试
虽推荐全量构建，但在大型项目中可按需指定模块：
# 仅构建 entera-demo-design-1-01 及其依赖的模块（如 entera-demo-design-1-00） mvn install -pl entera-demo-design-1-01 -am # 仅构建 entera-demo-design-1-01（不编译依赖项，要求依赖已存在） mvn install -pl entera-demo-design-1-01
其中 -pl（--projects）指定模块，-am（--also-make）自动包含其依赖模块。但首次构建或 CI 环境中，仍强烈建议使用 mvn install 全量执行。
✅ 总结
| 场景 | 推荐操作 | 原因 |
|---|---|---|
| 多模块项目（含 <modules>） | 在父 POM 目录执行 mvn install | 启用 reactor，保障依赖解析、顺序编译、元数据一致性 |
| 单独构建某子模块 | 使用 -pl <module-id> -am | 避免遗漏上游依赖，但需确保环境干净 |
| 误删本地仓库或调试依赖 | 清理后仍从父目录构建 | .m2 中的产物是副产品，reactor 才是权威来源 |
遵循这一规范，您将彻底告别“Could not find artifact”类错误，让 Maven 发挥其多模块协同构建的设计本意。
