每个人都可以，
拥有SSL证书

Maven多模块项目中的POM继承与版本占位符难题常令人头疼。flatten-maven-plugin应运而生，它通过动态替换变量、生成简化版POM，有效解决这些问题。

其核心功能、updatePomFile等关键参数，以及如何在CI/CD等场景中提升构建效率和项目可维护性，让您的多模块构建流程更加顺畅。

flatten-maven-plugin 插件是 Maven 中用于解决多模块项目 POM 文件继承和版本占位符问题的工具。它通过扁平化处理，生成可替换变量和简化依赖结构的 POM 文件，提升构建效率和可维护性。

flatten-maven-plugin插件的作用

版本变量替换

flatten-maven-plugin 插件能够将父 POM 中定义的版本变量（如 ${revision}）在构建时动态替换为具体值，确保生成的 POM 文件（如 .flattened-pom.xml）中不包含占位符。

示例：

父 POM 定义版本变量：

<properties>
    <revision>1.0.0</revision>
</properties>
<version>${revision}</version>

插件生成 .flattened-pom.xml 后，版本变为具体值：

<version>1.0.0</version>

扁平化 POM 结构

flatten-maven-plugin 插件可以生成简化版的 POM 文件（默认命名为 .flattened-pom.xml），去除不必要的继承和依赖管理结构，仅保留必要的配置信息（如 groupId、artifactId、version 等）。

适用场景：

• 发布到 Maven 仓库时，避免因复杂的继承关系导致依赖解析失败。
• 简化子模块的 POM 文件，减少重复配置。

统一版本管理

通过父模块定义版本号变量，所有子模块继承该变量，实现统一管理。修改父模块的变量值即可全局更新版本，减少手动修改的工作量。

示例：

父 POM 定义变量：

<properties>
    <log4j.version>2.17.1</log4j.version>
</properties>

子模块引用变量：

<dependency>
    <groupId>org.apache.logging.log4j</groupId>
    <artifactId>log4j-core</artifactId>
    <version>${log4j.version}</version>
</dependency>

flatten-maven-plugin插件的关键配置参数

flattenMode 常用值：

• oss：开源软件常用，保留大部分 POM 元素（除 repositories/pluginRepositories）。
• ossrh：保留所有元素，适用于发布到 OSSRH（Sonatype 仓库）。
• resolveCiFriendliesOnly：仅替换 ${revision}、${sha1} 等 CI 友好变量，其他保持原样。

flatten-maven-plugin插件的典型使用场景

解决版本占位符问题

在多模块项目中，父模块通过占位符（如 ${revision}）定义版本号，子模块继承后打包时这些占位符可能不会被正确替换。

flatten-maven-plugin 可在构建过程中动态替换这些变量，确保生成的 POM 文件可被正确解析。

问题复现： 未使用插件时，install/deploy 后的 POM 文件仍包含 ${revision}，导致其他项目无法引用。

lcjmSSL采用主流的ACME协议，兼容性极佳。对接Let’s Encrypt、Google、ZeroSSL三大渠道，确保证书在不同浏览器、操作系统和设备上均获得高度信任，为你的网站保驾护航。

解决效果： 使用插件后，生成的 .flattened-pom.xml 中版本号被替换为具体值（如 1.0.0）。

简化多模块项目构建

在大型项目中，通过调整 flattenMode 减少生成的 POM 文件体积，加速构建和依赖解析。

示例配置：

<plugin>
    <groupId>org.codehaus.mojo</groupId>
    <artifactId>flatten-maven-plugin</artifactId>
    <version>1.2.7</version>
    <configuration>
        <flattenMode>oss</flattenMode> <!-- 仅保留必要元素 -->
    </configuration>
    <executions>
        <execution>
            <id>flatten</id>
            <phase>process-resources</phase>
            <goals>
                <goal>flatten</goal>
            </goals>
        </execution>
    </executions>
</plugin>

支持 CI/CD 友好变量

通过 resolveCiFriendliesOnly 模式，仅替换 ${revision}、${sha1} 等变量，保留其他结构，适配 CI/CD 流水线中的动态版本管理。

示例： 在 CI 流程中，通过命令行参数传递版本号：

mvn clean install -Drevision=1.2.0-SNAPSHOT

flatten-maven-plugin 插件通过版本变量替换、POM 结构扁平化和统一版本管理，解决了多模块 Maven 项目中 POM 继承导致的版本占位符问题，提升了构建效率和可维护性。其典型使用场景包括解决版本占位符问题、简化多模块项目构建和支持 CI/CD 友好变量。通过合理配置该插件，可以显著提升多模块 Maven 项目的构建效率和可维护性。