如何在Maven多模块项目中仅定义一次项目版本

你可以通过父POM继承+版本属性统一管理的方式，实现仅在一处定义项目版本，避免重复配置。以下是具体可行方案：

1. 核心：在parent-module中统一定义版本 #

把项目版本（如2.0.0）作为唯一源，写在parent-module/pom.xml里，同时这里保留你原本的依赖版本管理：

<!-- parent-module/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 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>

    <groupId>com.yourcompany</groupId>
    <artifactId>parent-module</artifactId>
    <version>2.0.0</version>
    <packaging>pom</packaging>

    <!-- 这里保留你原本的依赖版本管理（dependencyManagement） -->
    <dependencyManagement>
        <!-- 你的依赖版本配置 -->
    </dependencyManagement>
</project>

2. 根POM继承parent-module并声明子模块 #

根目录的pom.xml不需要自己定义版本，直接继承parent-module，同时把所有子模块（包括parent-module）加入模块列表，确保构建顺序正确：

<!-- maven-project/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 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>

    <parent>
        <groupId>com.yourcompany</groupId>
        <artifactId>parent-module</artifactId>
        <version>2.0.0</version>
        <relativePath>parent-module/pom.xml</relativePath>
    </parent>

    <artifactId>maven-project</artifactId>
    <packaging>pom</packaging>

    <modules>
        <module>parent-module</module>
        <module>module-a</module>
        <module>module-b</module>
        <module>module-c</module>
    </modules>
</project>

3. 子模块直接继承parent-module #

module-a、module-b、module-c的pom.xml不需要写自己的版本，通过继承parent-module自动获取版本：

<!-- module-a/pom.xml（module-b、module-c同理） -->
<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 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>

    <parent>
        <groupId>com.yourcompany</groupId>
        <artifactId>parent-module</artifactId>
        <version>2.0.0</version>
        <relativePath>../parent-module/pom.xml</relativePath>
    </parent>

    <artifactId>module-a</artifactId>
    <!-- 无需手动写version，自动继承父模块版本 -->

    <!-- 模块依赖配置：依赖版本可直接用parent-module中dependencyManagement定义的，无需重复写版本号 -->
</project>

进阶：用${revision}属性实现动态版本管理 #

如果需要更灵活的版本控制（比如CI/CD中批量修改版本），可以在parent-module里用属性定义版本，只改一处就能全局更新：

<!-- parent-module/pom.xml -->
<project>
    <modelVersion>4.0.0</modelVersion>

    <groupId>com.yourcompany</groupId>
    <artifactId>parent-module</artifactId>
    <version>${revision}</version>
    <packaging>pom</packaging>

    <properties>
        <revision>2.0.0</revision> <!-- 唯一的版本定义处 -->
    </properties>

    <!-- 依赖管理配置 -->
</project>

然后根POM和所有子模块的parent节点中，版本改为${revision}即可：

<parent>
    <groupId>com.yourcompany</groupId>
    <artifactId>parent-module</artifactId>
    <version>${revision}</version>
    <relativePath>../parent-module/pom.xml</relativePath>
</parent>

如果遇到属性未解析的问题，可使用flatten-maven-plugin插件处理，确保最终生成的POM版本为实际值。

关于之前的报错说明 #

你之前遇到的'version' child tag should be defined错误，是因为Maven要求每个POM必须明确版本：要么自己定义，要么通过继承父POM获取，不能直接省略。

内容的提问来源于stack exchange，提问作者fascynacja