多模块Maven项目统一版本设置问题咨询：警告及子模块运行异常

解决版本表达式警告的核心思路 #

Maven低版本不支持直接在<version>标签中使用属性引用，因此会抛出'version' contains an expression but should be a constant警告。要解决这个问题，需借助Maven官方推荐的版本管理插件或规范的属性配置方式，而非直接在子模块版本中写属性引用。

标准解决方案：revision属性+Flatten插件 #

1. 父POM配置 #

在根项目的pom.xml中定义revision属性，同时配置Flatten插件消除警告：

<project>
  <modelVersion>4.0.0</modelVersion>
  <groupId>com.example</groupId>
  <artifactId>parent-project</artifactId>
  <version>${revision}</version>
  <packaging>pom</packaging>

  <properties>
    <!-- 默认统一版本，可通过命令行覆盖 -->
    <revision>1.0.0-SNAPSHOT</revision>
  </properties>

  <modules>
    <module>module-a</module>
    <module>module-b</module>
  </modules>

  <build>
    <plugins>
      <plugin>
        <groupId>org.codehaus.mojo</groupId>
        <artifactId>flatten-maven-plugin</artifactId>
        <version>1.4.1</version>
        <executions>
          <execution>
            <id>flatten</id>
            <phase>process-resources</phase>
            <goals>
              <goal>flatten</goal>
            </goals>
          </execution>
          <execution>
            <id>flatten-clean</id>
            <phase>clean</phase>
            <goals>
              <goal>clean</goal>
            </goals>
          </execution>
        </executions>
        <configuration>
          <!-- 生成扁平化POM，替换属性为实际值，消除警告 -->
          <flattenMode>resolveCiFriendliesOnly</flattenMode>
        </configuration>
      </plugin>
    </plugins>
  </build>
</project>

2. 子模块POM配置 #

所有子模块无需单独指定版本，直接继承父项目的revision属性：

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

  <modelVersion>4.0.0</modelVersion>
  <artifactId>module-a</artifactId>
  <!-- 无需手动写version，自动继承父项目版本 -->
</project>

3. 解决嵌套模块运行异常问题 #

如果使用revision后嵌套子模块（如模块内还有子模块）无法正常运行，排查以下几点：

• 所有层级的子模块必须正确继承父项目的revision属性，禁止在中间层级硬写版本号
• 执行Maven命令时，优先在根目录运行；若需指定模块，使用完整路径，比如mvn clean install -pl module-a/sub-module
• 确保Maven版本在3.5.0及以上，低版本对revision属性的支持存在缺陷

替代方案：Versions插件批量更新版本 #

若不想使用revision属性，可通过Versions插件统一修改所有模块版本：

# 根目录执行，将所有模块版本更新为1.0.0-SNAPSHOT
mvn versions:set -DnewVersion=1.0.0-SNAPSHOT
# 确认版本更新（取消更新执行mvn versions:revert）
mvn versions:commit

关键注意事项 #

• 不要直接在子模块<version>中写${revision}却不配置Flatten或Release插件，这会触发版本表达式警告
• 团队协作时，建议将revision默认值设为快照版本，发布时通过命令行指定正式版本：mvn clean deploy -Drevision=1.0.0

内容的提问来源于stack exchange，提问作者a.nayebi