子Maven POM继承父插件时，子配置块被忽略的问题排查

问题场景 #

维护大量基于父POM的子Maven项目，此前仅依赖继承正常。近期将插件配置迁移至父POM的pluginManagement块中，子POM仅声明插件的groupId和artifactId即可继承版本，但遇到子POM自定义的configuration被父POM配置覆盖的问题：

• 父POM全局configuration为空时，子POM的配置也被清空；
• 父POM添加测试配置后，子POM有效配置完全沿用父的内容；
• 临时移除父POM的插件定义，子POM配置可正常生效。

使用Maven版本：3.8.2，测试插件：jacoco-maven-plugin

配置示例 #

父POM的pluginManagement插件配置 #

<plugin>
    <groupId>org.jacoco</groupId>
    <artifactId>jacoco-maven-plugin</artifactId>
    <version>${jacoco.maven.plugin.version}</version>
    <configuration>
        <excludes> <exclude>abc</exclude> </excludes>
    </configuration>
    <executions>
        <execution>
            <id>pre-unit-test</id>
            <goals> <goal>prepare-agent</goal> </goals>
            <configuration>
                <propertyName>surefireArgLine</propertyName>
            </configuration>
        </execution>
        <execution>
            <id>post-unit-test</id>
            <phase>test</phase>
            <goals> <goal>report</goal> </goals>
            <configuration>
                <outputDirectory>${jacoco.path}</outputDirectory>
            </configuration>
        </execution>
        <execution>
            <id>pre-integration-test</id>
            <phase>pre-integration-test</phase>
            <goals> <goal>prepare-agent</goal> </goals>
            <configuration>
                <destFile>${sonar.jacoco.itReportPath}</destFile>
                <propertyName>failsafeArgLine</propertyName>
            </configuration>
        </execution>
        <execution>
            <id>post-integration-test</id>
            <phase>post-integration-test</phase>
            <goals> <goal>report</goal> </goals>
            <configuration>
                <dataFile>${sonar.jacoco.itReportPath}/</dataFile>
                <outputDirectory>${jacoco.itPath}</outputDirectory>
            </configuration>
        </execution>
    </executions>
</plugin>

子POM的插件配置 #

<plugin>
    <groupId>org.jacoco</groupId>
    <artifactId>jacoco-maven-plugin</artifactId>
    <configuration>
        <excludes>
            <exclude>{specificpath}</exclude>
            ...
        </excludes>
    </configuration>
</plugin>

有效POM的异常结果（部分） #

<plugin>
  <groupId>org.jacoco</groupId>
  <artifactId>jacoco-maven-plugin</artifactId>
  <version>${jacoco.maven.plugin.version}</version>
  <executions>
    <execution>
      <id>pre-unit-test</id>
      <goals>
        <goal>prepare-agent</goal>
      </goals>
      <configuration>
        <propertyName>surefireArgLine</propertyName>
        <excludes>
          <exclude>abc</exclude>
        </excludes>
      </configuration>
    </execution>
    <!-- 其他execution省略 -->
  </executions>
  <configuration>
    <excludes>
      <exclude>abc</exclude>
    </excludes>
  </configuration>
</plugin>

可见：

• 全局configuration仅保留父POM的abc排除规则，子POM的{specificpath}未生效；
• 父POM的全局excludes被同步到每个execution的configuration中。

原因分析 #

Maven插件配置的继承逻辑并非默认“子配置覆盖父配置”，而是合并策略：

1. 简单类型配置（如字符串）：子配置会覆盖父配置；
2. 集合类型配置（如excludes、includes）：子配置默认追加到父配置后，而非替换；
3. 父POM的全局configuration会自动合并到每个execution的configuration中，导致子POM的全局配置无法覆盖已合并的内容。

解决方案 #

方案1：强制子配置完全覆盖父配置 #

在子POM的configuration标签上添加combine.self="override"属性，指定子配置完全覆盖父的全局配置：

<plugin>
    <groupId>org.jacoco</groupId>
    <artifactId>jacoco-maven-plugin</artifactId>
    <configuration combine.self="override">
        <excludes>
            <exclude>{specificpath}</exclude>
            ...
        </excludes>
    </configuration>
</plugin>

方案2：清空父集合配置后添加子内容 #

针对集合类型配置（如excludes），添加<clear>true</clear>标签，先清空父的集合内容，再添加子的配置：

<plugin>
    <groupId>org.jacoco</groupId>
    <artifactId>jacoco-maven-plugin</artifactId>
    <configuration>
        <excludes>
            <clear>true</clear>
            <exclude>{specificpath}</exclude>
            ...
        </excludes>
    </configuration>
</plugin>

方案3：父POM移除全局配置，子POM按需定义 #

若不需要全局通用配置，可将父POM中的全局configuration删除，仅保留version和executions，子POM根据自身需求添加全局或execution级别的配置。

内容的提问来源于stack exchange，提问作者David M. Karr