Maven继承机制通过父POM统一管理多模块项目的依赖版本、插件配置和属性,子模块继承后自动复用配置,避免重复声明和版本不一致;父POM必须packaging=pom,使用dependencyManagement声明版本,子模块仅需声明groupId和artifactId即可生效。

在多模块 Java 项目中,重复配置主要出现在各子模块的 pom.xml 里——比如相同的依赖版本、插件配置、Java 编译级别、编码设置等。靠手动同步不仅易错,还难维护。Maven 的 继承机制 就是专为解决这个问题设计的,核心是用一个父 POM 统一声明“可复用的配置模板”,子模块只需声明继承关系,就能自动获得这些配置。
父模块必须是 packaging=pom
父模块本身不写业务代码,只管配置管理。因此它的 <packaging> 必须设为 pom,且通常删掉 src 目录。否则 Maven 会尝试编译它,报错或行为异常。
- 父 POM 中定义
<groupId>、<version>(建议用统一版本号,如1.0.0或1.0.0-SNAPSHOT) - 子模块通过
<parent>显式引用:包含groupId、artifactId、version和可选的<relativePath>(默认../pom.xml) -
<relativePath>写错是常见错误,尤其当父模块不在直接上级目录时,务必核对路径
用 dependencyManagement 统一版本,而不是 dependencies
父模块中声明依赖,不是为了“引入”依赖,而是为了“约定版本”。真正生效要靠子模块自己声明依赖(只写 groupId 和 artifactId),这样 Maven 才会按父模块指定的版本解析。
- 父 POM 中把公共依赖放进
<dependencyManagement>块,例如 Spring Boot 版本、Logback、JUnit 等 - 子模块的
<dependencies>里只写 G 和 A,不写 V;Maven 自动匹配父模块定义的版本 - 若某个子模块需要不同版本,可在自己 POM 中显式覆盖该依赖的
<version>
集中管理插件和属性,避免逐个配置
除了依赖,编译插件(如 maven-compiler-plugin)、打包插件、编码格式(project.build.sourceEncoding)、Java 版本(maven.compiler.source/target)等,都适合提到父 POM 中。
立即学习“Java免费学习笔记(深入)”;
- 在父 POM 的
<properties>里定义通用属性,如<java.version>17</java.version>,子模块可用${java.version}引用 - 插件配置放在
<build><pluginManagement>下,子模块启用时只需写插件坐标,无需重复配置参数 - 这样改 JDK 版本或源码编码,只需改父 POM 一处,所有子模块自动同步
继承 ≠ 聚合,别混用
继承解决的是“配置复用”,聚合(<modules>)解决的是“一键构建”。两者常共存,但作用不同:
- 父模块可以同时是聚合根:自身
<packaging>pom</packaging>,又含<modules>列出所有子模块 - 但子模块继承父模块,和是否被聚合无关;一个子模块可以继承父 POM,却不被当前聚合根包含
- 误把聚合当继承,会导致子模块无法获取父配置;反之,只继承不聚合,则无法用
mvn clean install一键构建全部模块


















