Maven Enforcer插件忽略Maven CI的<revision>属性问题

我来帮你搞定这个问题——结合你描述的项目结构（base-project-pom带Enforcer、reactor-parent用revision统一版本、两个叶子模块引用${revision}），这类问题大多是因为Maven CI版本机制的插值时机和Enforcer的执行阶段不匹配导致的，下面给你拆解场景、问题根源和具体解决方案：

先明确你的项目结构 #

• base-project-pom：顶层父POM，配置了maven-enforcer-plugin并绑定到validate阶段执行
• reactor-parent：打包类型为pom，通过<revision>属性统一管控所有模块版本
• service & service-test：两个业务模块，均使用${revision}引用统一版本

问题根源 #

Maven的CI友好版本机制（用revision/sha1/changelist属性管理版本）是在项目模型构建的后期才完成插值替换的，但validate阶段属于构建流程的早期阶段——这就导致Enforcer插件执行时，${revision}还没被替换成实际版本号，插件会把${revision}当作真实版本字符串去校验，触发规则失败（比如禁止SNAPSHOT版本、版本格式校验不通过等）。

具体解决方案 #

方案1：调整Enforcer的执行阶段 #

把Enforcer的执行时机从validate移到initialize之后的阶段（比如process-resources），这时候版本插值已经完成，插件能拿到真实版本号：

<plugin>
  <groupId>org.apache.maven.plugins</groupId>
  <artifactId>maven-enforcer-plugin</artifactId>
  <version>3.4.1</version>
  <executions>
    <execution>
      <id>enforce-version-rules</id>
      <!-- 替换原有的validate阶段 -->
      <phase>process-resources</phase>
      <goals>
        <goal>enforce</goal>
      </goals>
      <configuration>
        <!-- 你的自定义校验规则 -->
        <rules>
          <requireReleaseVersion>
            <message>正式构建禁止使用SNAPSHOT版本！</message>
          </requireReleaseVersion>
        </rules>
      </configuration>
    </execution>
  </executions>
</plugin>

方案2：在reactor-parent中显式传递版本属性 #

让reactor-parent在继承base-project-pom时，显式定义revision属性，同时让Enforcer插件使用插值后的${project.version}而非直接引用${revision}：
在reactor-parent的POM中添加：

<properties>
  <!-- 显式定义统一版本，支持命令行覆盖：mvn clean install -Drevision=1.0.0 -->
  <revision>1.0.0-SNAPSHOT</revision>
</properties>

<build>
  <pluginManagement>
    <plugins>
      <plugin>
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-enforcer-plugin</artifactId>
        <configuration>
          <!-- 使用project.version，它是插值后的实际版本号 -->
          <rules>
            <requireVersion>
              <version>[${project.version}]</version>
              <message>模块版本必须与统一revision保持一致！</message>
            </requireVersion>
          </rules>
        </configuration>
      </plugin>
    </plugins>
  </pluginManagement>
</build>

方案3：升级到Maven 3.6.2+利用插值优化 #

如果你使用的是Maven 3.6.2及以上版本，官方对CI版本的插值时机做了优化，早期阶段也能拿到${project.version}的插值结果——这种情况下可以保留validate阶段，只需要把Enforcer规则里的${revision}换成${project.version}即可：

<plugin>
  <groupId>org.apache.maven.plugins</groupId>
  <artifactId>maven-enforcer-plugin</artifactId>
  <version>3.4.1</version>
  <executions>
    <execution>
      <id>enforce-version-rules</id>
      <phase>validate</phase>
      <goals>
        <goal>enforce</goal>
      </goals>
      <configuration>
        <rules>
          <requireReleaseVersion>
            <message>正式构建禁止使用SNAPSHOT版本！</message>
            <!-- 使用project.version获取真实版本 -->
            <version>${project.version}</version>
          </requireReleaseVersion>
        </rules>
      </configuration>
    </execution>
  </executions>
</plugin>

验证方式 #

执行构建命令时可以手动指定revision参数验证效果：

mvn clean install -Drevision=1.0.0

检查Enforcer插件是否正常执行，没有出现${revision}未插值的报错。

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