构建与依赖 / 系统课时

父 POM 的继承机制

父 POM 的继承机制

Maven 子项目通过 <parent> 先找到父 POM,再把可继承的属性、依赖管理和构建配置合并进自己的有效模型。理解这套合并规则后,你就能把公共配置放在正确层级,并用 effective-pom 验证最终结果。

学习目标

  • 看懂 <parent> 的坐标与 relativePath 如何定位父 POM。
  • 判断属性、依赖管理、插件管理等配置是否会被子模块继承。
  • 用有效 POM 检查继承后的真实配置。

parent 如何定位父 POM

子模块至少通过父项目的 groupId、artifactId、version 标识父 POM。relativePath 默认是 ../pom.xml;父 POM 不在这个位置时,可以写实际相对路径,若写成空的 <relativePath/>,则跳过默认相对路径查找,转而按父坐标从可用的 Maven 模型来源解析。

父 POM 到子模块有效模型的继承关系

父 POM 示例:

xml
<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
  <modelVersion>4.0.0</modelVersion>

  <groupId>com.example</groupId>
  <artifactId>company-parent</artifactId>
  <version>1.0.0</version>
  <packaging>pom</packaging>

  <properties>
    <maven.compiler.release>17</maven.compiler.release>
    <commons-lang3.version>3.14.0</commons-lang3.version>
  </properties>

  <dependencyManagement>
    <dependencies>
      <dependency>
        <groupId>org.apache.commons</groupId>
        <artifactId>commons-lang3</artifactId>
        <version>${commons-lang3.version}</version>
      </dependency>
    </dependencies>
  </dependencyManagement>

  <build>
    <pluginManagement>
      <plugins>
        <plugin>
          <groupId>org.apache.maven.plugins</groupId>
          <artifactId>maven-surefire-plugin</artifactId>
          <version>3.2.5</version>
        </plugin>
      </plugins>
    </pluginManagement>
  </build>
</project>

子模块只保留自身差异:

xml
<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
  <modelVersion>4.0.0</modelVersion>

  <parent>
    <groupId>com.example</groupId>
    <artifactId>company-parent</artifactId>
    <version>1.0.0</version>
    <relativePath>../pom.xml</relativePath>
  </parent>

  <artifactId>app</artifactId>

  <dependencies>
    <dependency>
      <groupId>org.apache.commons</groupId>
      <artifactId>commons-lang3</artifactId>
    </dependency>
  </dependencies>

  <build>
    <plugins>
      <plugin>
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-surefire-plugin</artifactId>
      </plugin>
    </plugins>
  </build>
</project>

这里子模块没有重复写项目 groupId、项目 version、commons-lang3 版本或 Surefire 版本,它们都会从父模型得到对应值。

哪些配置会继承

父 POM 会把大量模型内容交给子 POM,但不是所有字段都按同一种方式处理。下面这组规则足够覆盖日常多模块项目。

配置 常见继承结果 实际用法
项目 groupId、version 子项目省略时继承 让一组模块共享发布坐标前缀与版本
properties 继承,可在子项目覆盖 统一 Java 版本、编码、依赖版本变量
dependencyManagement 继承管理规则,不自动引入依赖 子模块声明依赖时省略版本
dependencies 通常直接继承 只放所有子模块都真正需要的依赖
build/pluginManagement 继承插件版本和默认配置 统一 Surefire、Compiler 等插件规则
build/plugins 默认可继承,插件可用 inherited 控制 统一确实要在子模块执行的构建行为
artifactId 不继承 每个子项目必须有自己的构件名
name 不应依赖父值 各模块按需填写可读名称

例如 8 个模块只有 2 个需要 JDBC 驱动时,不要把驱动放进父 POM 的 dependencies,否则其余 6 个模块也会继承;应把版本放进 dependencyManagement,再由那 2 个模块自行声明。

用 effective-pom 验证合并结果

进入子模块目录执行 Maven Help Plugin:

bash
mvn help:effective-pom -Doutput=effective-pom.xml

预期结果是在当前目录生成 effective-pom.xml。文件很长,但应能找到类似下面的关键片段,说明父项目中的版本已经合并进子项目模型:

xml
<groupId>com.example</groupId>
<artifactId>app</artifactId>
<version>1.0.0</version>

<dependency>
  <groupId>org.apache.commons</groupId>
  <artifactId>commons-lang3</artifactId>
  <version>3.14.0</version>
</dependency>

<plugin>
  <groupId>org.apache.maven.plugins</groupId>
  <artifactId>maven-surefire-plugin</artifactId>
  <version>3.2.5</version>
</plugin>

如果 effective-pom.xml 里没有预期版本,先检查 <parent> 的三段坐标是否完全一致,再检查 relativePath 是否指向正确 POM,最后看子模块是否用同名属性或更近层级的管理配置覆盖了父值。

继承和聚合不要混为一谈

继承由子 POM 的 <parent> 建立,聚合则由某个 POM 的 <modules> 决定“执行一次 Maven 命令时要同时构建哪些模块”。两者经常写在同一个根 POM 中,但并不是同一机制。

例如根 POM 可以通过 <modules> 聚合 app 和 service,而两个模块都继承 company-parent;也可以让一个公司级父 POM 只提供规则、完全不聚合任何业务模块。判断时看两个问题:配置从哪里继承,就查 <parent>;哪些模块一起进入 Reactor 构建,就查 <modules>。

把公共版本放进 dependencyManagement、公共插件版本放进 pluginManagement、真正所有模块都需要的配置才放进可直接继承区域,最后用 help:effective-pom 核对实际模型,能避免父 POM 越写越大而难以判断配置来源。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

父 POM 的继承机制

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通