1. 概述
在 Maven 的多模块项目中，最终生效的 POM 是模块及其所有父级配置合并后的结果。
为了避免模块之间重复冗余的配置，我们通常会把通用配置放在父 POM 中。然而，有时候某个子模块需要自定义配置，又不想影响其他兄弟模块，这就带来了一些挑战。
本文将带你了解如何覆盖父 POM 中的插件配置。
2. 默认配置继承机制
插件配置允许我们在多个项目中复用相同的构建逻辑。如果父 POM 中定义了某个插件，子模块会自动继承它，无需额外声明——这和面向对象中的“继承”类似。
Maven 在合并配置时，按 XML 元素级别进行合并。如果子模块中定义了某个元素，并且值不同，它就会覆盖父模块中的对应元素。我们来看一个具体例子。
2.1. 项目结构
我们先定义一个多模块 Maven 项目用于演示。项目结构如下：
+ parent
+ child-a
+ child-b
假设我们要为 maven-compiler-plugin 配置不同的 Java 版本。我们希望项目默认使用 Java 11，但 child-a 使用 Java 8。
首先配置父 POM：
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-compiler-plugin</artifactId>
<configuration>
<source>11</source>
<target>11</target>
<maxmem>512m</maxmem>
</configuration>
</plugin>
这里我们还配置了 maxmem 属性，希望子模块也能继承。但 child-a 需要自己的编译设置。
于是我们为 child-a 配置如下：
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-compiler-plugin</artifactId>
<configuration>
<source>1.8</source>
<target>1.8</target>
</configuration>
</plugin>
配置完成后，我们来看看最终生效的 POM 是什么样子。
2.2. 理解生效的 POM（Effective POM）
生效的 POM 受多种因素影响，包括继承、Profile、外部设置等。我们可以在 child-a 目录下运行以下命令查看实际生效的配置：
mvn help:effective-pom
输出中你会看到：
...
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-compiler-plugin</artifactId>
<configuration>
<source>1.8</source>
<target>1.8</target>
<maxmem>512m</maxmem>
</configuration>
</plugin>
✅ 正如预期，child-a 的 source 和 target 被成功覆盖。
⚠️ 但注意，它还保留了父模块中的 maxmem 配置。
📌 结论：如果子模块定义了某个配置项，就使用子模块的；否则继承父模块的。
3. 高级配置继承控制
有时候默认的继承策略不能满足需求，我们需要更精细地控制合并行为。Maven 提供了一些 XML 属性来实现这一点。
这些属性需要加在我们希望控制的 XML 元素上，并且只对一级子模块生效。
3.1. 处理列表配置
在前面的例子中，我们看到如果子模块重新定义了某个元素，就会完全覆盖父模块的配置。但如果是列表型配置呢？
比如使用 maven-resources-plugin 配置多个资源目录。
先在父 POM 中配置一个资源目录：
<plugin>
<artifactId>maven-resources-plugin</artifactId>
<configuration>
<resources>
<resource>
<directory>parent-resources</directory>
</resource>
</resources>
</configuration>
</plugin>
此时 child-a 会继承这个配置。但我们希望它使用另一个资源目录：
<plugin>
<artifactId>maven-resources-plugin</artifactId>
<configuration>
<resources>
<resource>
<directory>child-a-resources</directory>
</resource>
</resources>
</configuration>
</plugin>
查看生效的 POM：
mvn help:effective-pom
...
<configuration>
<resources>
<resource>
<directory>child-a-resources</directory>
</resource>
</resources>
</configuration>
✅ 整个列表被子模块的配置完全覆盖了。
3.2. 追加父配置（Append）
如果我们希望子模块在使用父模块配置的基础上，再追加自己的资源目录，可以使用 combine.children="append" 属性。
在父 POM 中配置如下：
<resources combine.children="append">
<resource>
<directory>parent-resources</directory>
</resource>
</resources>
此时生效的 POM 将包含两个资源目录：
mvn help:effective-pom
....
<resources combine.children="append">
<resource>
<directory>parent-resources</directory>
</resource>
<resource>
<directory>child-a-resources</directory>
</resource>
</resources>
⚠️ 注意：combine 属性不会传递到嵌套元素中。如果结构更复杂，嵌套元素仍然按默认策略合并。
3.3. 强制覆盖（Override）
在上面的例子中，子模块并不能完全控制最终结果，因为父模块设置了 combine.children="append"。如果子模块想彻底覆盖，可以使用 combine.self="override"：
<resources combine.self="override">
<resource>
<directory>child-a-resources</directory>
</resource>
</resources>
此时，子模块完全掌控了最终配置：
mvn help:effective-pom
...
<resources combine.self="override">
<resource>
<directory>child-a-resources</directory>
</resource>
</resources>
4. 禁止插件继承
前面的合并控制策略适用于微调，但如果某个子模块完全不想继承某个插件，该怎么办？
✅ 简单粗暴的方法是：在父 POM 的插件配置中添加 <inherited>false</inherited>：
<plugin>
<inherited>false</inherited>
<groupId>org.apache.maven.plugins</groupId>
...
</plugin>
这样该插件只会作用于父模块本身，不会传递给任何子模块。
5. 总结
本文我们系统地学习了 Maven 插件配置的继承与覆盖机制：
- ✅ 默认继承行为是“子覆盖父”
- ✅ 列表型配置默认是整体覆盖
- ✅ 可通过
combine.children="append"实现追加 - ✅ 子模块可通过
combine.self="override"强制覆盖父策略 - ✅ 插件可设置
<inherited>false</inherited>来禁止继承
这些技巧在管理大型多模块项目时非常实用，能有效避免配置混乱。
一如既往，本文代码示例可在 GitHub 获取。