Maven 的 reactor 机制自动按依赖关系拓扑排序构建模块，无需手动排序；关键在于规范的项目结构和依赖声明，包括父 POM 中通过 显式声明所有子模块、避免循环依赖与隐式依赖断裂，并可通过 -pl 和 -am 参数精准控制构建范围。

Maven 的 reactor 机制会自动按依赖关系确定构建顺序，不需要手动排序。关键在于项目结构和依赖声明是否规范——只要模块间依赖正确、父 POM 配置得当，执行 mvn clean install 就能自动完成拓扑排序并依次构建。

确保 reactor 能识别所有模块

根 POM（packaging=pom）中必须通过 显式声明所有子模块路径，例如：

• common
• service-api
• service-impl

缺失任一声明，对应模块就不会进入 reactor 构建图，即使它被其他模块依赖，也会报 “could not find artifact” 错误。

依赖方向决定实际构建顺序

reactor 不按 列表顺序构建，而是根据依赖关系生成有向无环图（DAG），优先构建被依赖者。例如：

• service-impl 依赖 service-api 和 common
• service-api 依赖 common
• 则构建顺序一定是：common → service-api → service-impl

即使 中把 service-impl 写在最前面，reactor 也会自动调整顺序，避免构建失败。

Java Api Extractor

从 Java 项目中提取 Controller 层接口定义为 JSON 数据。

下载

按需裁剪 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”
• 隐式依赖缺失：子模块未声明 或 groupId 与父 POM 不一致 → reactor 无法识别归属，该模块被忽略

检查方式：执行 mvn help:effective-pom 确认子模块实际解析出的 groupId 和 parent 是否匹配根 POM。