如何引用采用Maven CI-Friendly Versions的SNAPSHOT依赖并解决版本变量问题

问题背景 #

现有4个pom.xml文件：ParentA、ChildA、ParentB、ChildB，其中ParentA是ChildA的父项目，ParentB是ChildB的父项目，ChildB依赖ChildA。所有pom均使用Maven CI友好版本格式<version>${revision}</version>指定版本，但执行mvn clean install后，本地.m2/repository中的pom仍保留${revision}变量，导致依赖项目无法正常引用。

解决方案 #

1. 使用flatten-maven-plugin（无需修改项目源码pom的最优方案） #

该插件可在构建过程中生成“扁平化”的pom文件，自动替换${revision}等CI友好变量为实际值，并将这个处理后的pom安装到本地仓库，同时完全保留项目目录中的原始pom不变。

命令行临时生效

执行构建时直接添加插件参数，单次构建有效：

mvn clean install -Dmaven.flatten.enabled=true -Dflatten.mode=resolveCiFriendliesOnly

• flatten.mode=resolveCiFriendliesOnly：仅替换CI相关变量（如${revision}、${changelist}），其他变量保持原样，精准匹配你的场景。

全局配置永久生效

若需要所有构建自动处理，可在本地~/.m2/settings.xml中添加全局profile：

<profiles>
  <profile>
    <id>flatten-ci-versions</id>
    <activation>
      <activeByDefault>true</activeByDefault>
    </activation>
    <build>
      <plugins>
        <plugin>
          <groupId>org.codehaus.mojo</groupId>
          <artifactId>flatten-maven-plugin</artifactId>
          <version>1.5.0</version>
          <executions>
            <execution>
              <id>flatten</id>
              <phase>process-resources</phase>
              <goals>
                <goal>flatten</goal>
              </goals>
              <configuration>
                <flattenMode>resolveCiFriendliesOnly</flattenMode>
                <updatePomFile>false</updatePomFile> <!-- 禁止修改项目目录中的原始pom -->
                <outputDirectory>${project.build.directory}</outputDirectory>
              </configuration>
            </execution>
            <execution>
              <id>flatten.clean</id>
              <phase>clean</phase>
              <goals>
                <goal>clean</goal>
              </goals>
            </execution>
          </executions>
        </plugin>
      </plugins>
    </build>
  </profile>
</profiles>

配置完成后，每次执行mvn clean install都会自动生成处理后的pom并安装到本地仓库，无需额外参数。

2. 手动替换并部署（临时应急方案） #

若不想使用插件，可手动生成替换变量后的pom并部署：

1. 指定具体版本构建项目：

   mvn clean package -Drevision=1.0.0-SNAPSHOT
   

2. 生成替换变量后的pom（可通过maven-resources-plugin过滤或手动替换），然后执行部署命令：

   mvn deploy:deploy-file -Dfile=target/ChildA-1.0.0-SNAPSHOT.jar -DpomFile=target/processed-pom.xml -DlocalRepositoryPath=~/.m2/repository
   

该方式步骤繁琐，仅适合临时场景。

核心说明 #

• 无需修改项目目录pom即可解决：通过flatten-maven-plugin的命令行参数或全局settings配置，完全不需要改动项目中的任何pom文件。
• 变量未替换的原因：Maven CI友好版本的设计初衷是让源码pom保留版本变量，方便CI工具统一管理版本，flatten-maven-plugin正是为了解决“源码pom保留变量，仓库pom使用实际版本”的矛盾而存在。

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