Maven 的 reactor 机制自动按依赖关系拓扑排序构建模块，无需手动排序；关键在于规范的项目结构和依赖声明，包括父 POM 中通过 显式声明所有子模块、避免循环依赖与隐式依赖断裂，并可通过 -pl 和 -am 参数精准控制构建范围。
Maven 的 reactor 机制会自动按依赖关系确定构建顺序，不需要手动排序。关键在于项目结构和依赖声明是否规范——只要模块间依赖正确、父 POM 配置得当，执行 mvn clean install 就能自动完成拓扑排序并依次构建。
确保 reactor 能识别所有模块
根 POM（packaging=pom）中必须通过 <modules></modules> 显式声明所有子模块路径，例如：
<module>common</module><module>service-api</module><module>service-impl</module>
缺失任一声明，对应模块就不会进入 reactor 构建图，即使它被其他模块依赖，也会报 “could not find artifact” 错误。
依赖方向决定实际构建顺序
reactor 不按 <modules></modules> 列表顺序构建，而是根据依赖关系生成有向无环图（DAG），优先构建被依赖者。例如：
- service-impl 依赖 service-api 和 common
- service-api 依赖 common
- 则构建顺序一定是：common → service-api → service-impl
即使 <modules></modules> 中把 service-impl 写在最前面，reactor 也会自动调整顺序，避免构建失败。
按需裁剪 reactor 范围
不总需要构建全部模块。可用以下命令精准控制：
-
mvn clean install -pl service-impl：只构建指定模块（不包含其依赖） -
mvn clean install -pl service-impl -am：构建 service-impl 及它直接/间接依赖的所有本地模块 -
mvn clean install -pl common,service-api：同时构建多个指定模块（及其各自依赖）
注意：-am 只作用于 -pl 列出的模块所依赖的本地模块，不会拉取远程仓库依赖。
避免循环依赖和隐式依赖断裂
reactor 对两类问题零容忍：
- 循环依赖：A 依赖 B，B 又依赖 A → 构建直接失败，提示 “Cycle detected”
-
隐式依赖缺失：子模块未声明
<parent></parent>或groupId与父 POM 不一致 → reactor 无法识别归属，该模块被忽略
检查方式：执行 mvn help:effective-pom 确认子模块实际解析出的 groupId 和 parent 是否匹配根 POM。
