一、 引言
在大型 Java 项目或微服务架构中，项目通常被拆分为多个模块（如 common、api、service、web）。如果缺乏统一的管理规范，项目会迅速陷入"依赖冲突"和"版本地狱"。本文将详细梳理如何通过根 POM 与子 POM 的配合，实现工程级别的标准化管理。
二、 根目录 POM：全局配置中心
根 POM（Parent POM）位于项目的最外层，其核心职责是定义标准 而非实现业务。
1. 声明聚合管理（Aggregation）
根 POM 的 <packaging> 必须设为 pom。通过 <modules> 标签将子模块纳入管理，实现一键构建。
xml
<groupId>com.example</groupId>
<artifactId>my-project</artifactId>
<version>1.0.0-SNAPSHOT</version>
<packaging>pom</packaging>
<modules>
<module>my-common</module>
<module>my-auth</module>
<module>my-gateway</module>
</modules>2. 版本号统一管理（Properties）
严禁在子模块中随处书写版本号。所有依赖的版本应提取至根 POM 的 <properties> 中，实现"一处修改，全局生效"。
xml
<properties>
<maven.compiler.source>17</maven.compiler.source>
<spring.boot.version>3.2.5</spring.boot.version>
<mysql.version>8.0.33</mysql.version>
<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
</properties>3. 版本锁定（Dependency Management）
这是根 POM 的精髓。使用 <dependencyManagement> 声明依赖。
- 特性 ：此处声明的依赖并不会被下载或引入项目中。
- 作用 ：它仅仅是一个"声明清单"，锁定这些依赖的版本号。当子模块需要使用时，只需引用
groupId和artifactId。
xml
<dependencyManagement>
<dependencies>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
<version>${spring.boot.version}</version>
</dependency>
</dependencies>
</dependencyManagement>三、 子模块 POM：具体业务实现
子模块（Child Module）专注于业务逻辑，其 POM 文件应保持极度精简。
1. 继承父工程
通过 <parent> 标签指向根 POM。
xml
<parent>
<groupId>com.example</groupId>
<artifactId>my-project</artifactId>
<version>1.0.0-SNAPSHOT</version>
</parent>2. 依赖引入规范
子模块引入依赖时，严禁书写 <version> 标签。
- 逻辑 ：Maven 会向上寻找父 POM 中的
<dependencyManagement>，并自动继承锁定的版本。 - 优势 ：确保了全项目所有模块使用的库版本绝对一致，规避
NoSuchMethodError冲突。
四、 插件管理规范
不仅 Jar 包需要管理，构建插件同样需要。
- 根 POM ：使用
<pluginManagement>统一配置插件的版本、JDK 编译版本及公共参数。 - 子 POM ：直接在
<build><plugins>中声明需要的插件名即可，无需重复配置参数。
五、 POM 管理核心对比表
| 特性项 | 根 POM (Parent) | 子模块 POM (Module) |
|---|---|---|
| 打包方式 | pom |
jar 或 war |
| 依赖管理 | dependencyManagement (版本锁定) |
dependencies (实际引用) |
| 版本号 | 定义变量并统一维护 | 禁止出现版本号 (继承父类) |
| 插件配置 | pluginManagement (预设配置) |
声明并启用特定插件 |
| 职责角色 | 决策者：定标准、锁版本 | 执行者：引依赖、写业务 |
六、 依赖治理进阶：保持依赖树的"纯净"
在 POM 管理中，如何处理第三方库带来的冗余内容是区分架构师水平的关键。
1. 传递性依赖排除（Exclusions）
当你在子模块中引入一个大依赖包（如 spring-boot-starter-web）时，它可能会自动带入一些你并不需要的第三方库。
- 操作规范 ：使用
<exclusions>标签明确剔除不需要的间接依赖。 - 目的：防止项目依赖过于臃肿，避免因不同路径带入不同版本的同一个 Jar 包而导致的运行时冲突（如日志框架冲突）。
xml
<dependency>
<groupId>com.example</groupId>
<artifactId>big-library</artifactId>
<exclusions>
<exclusion>
<groupId>org.unwanted</groupId>
<artifactId>useless-jar</artifactId>
</exclusion>
</exclusions>
</dependency>2. 正确使用作用域（Scope）
在 POM 中明确每一个依赖的使用时机，是精简产物包体积的核心：
test：只在测试代码中有效（如 JUnit），打包时不会包含。provided：编译时需要，但运行时由环境提供（如servlet-api），不打包。runtime：编译时不需要，仅在运行期间需要（如数据库驱动实现）。
七、 总结
多模块项目的 POM 管理核心在于 "权限上移，配置下沉"。根 POM 负责定义统一的版本标准和构建逻辑；子 POM负责具体的业务落地。通过这种高度一致性的管理，不仅能大幅降低维护成本，更能保障生产环境的构建稳定性。