Maven多模块项目CI友好版本配置失败问题求助

问题根源 #

你遇到的问题核心原因如下：

• flatten-maven-plugin仅在主pom的pluginManagement中做了配置，未绑定到实际构建生命周期，导致子模块的pom未被扁平化处理，传递依赖中的${project.version}（实际映射${revision}）未被替换为具体版本号。
• 子模块依赖内部模块时使用${project.version}，该依赖的传递依赖解析时，版本号以${revision}原样传递，Maven误将其当作真实版本，去远程仓库查找不存在的${revision}版本资源。

具体解决方案 #

1. 绑定flatten-maven-plugin到全模块构建生命周期 #

在主pom的<build><plugins>节点下添加插件执行配置，让所有子模块构建时自动执行扁平化处理：

<build>
    <pluginManagement>
        <!-- 保留原有pluginManagement配置 -->
        <plugins>
            <plugin>
                <groupId>org.codehaus.mojo</groupId>
                <artifactId>flatten-maven-plugin</artifactId>
                <version>1.1.0</version>
                <configuration>
                    <updatePomFile>true</updatePomFile>
                    <flattenMode>resolveCiFriendliesOnly</flattenMode>
                </configuration>
            </plugin>
        </plugins>
    </pluginManagement>
    <!-- 新增：绑定插件到生命周期，确保所有子模块执行扁平化 -->
    <plugins>
        <plugin>
            <groupId>org.codehaus.mojo</groupId>
            <artifactId>flatten-maven-plugin</artifactId>
            <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>
        </plugin>
    </plugins>
</build>

此配置会在构建时将所有pom中的${revision}替换为具体版本号，确保传递依赖的版本被正确解析。

2. 优化内部模块依赖配置（可选，更规范） #

多模块项目中，内部依赖可直接省略<version>标签，Maven会自动继承当前项目版本（即${revision}对应的实际版本），从根源避免版本变量传递问题：

<dependencies>
    <dependency>
        <groupId>${project.groupId}</groupId>
        <artifactId>own-dependency-jar</artifactId>
        <scope>provided</scope>
        <!-- 移除<version>${project.version}</version> -->
    </dependency>
</dependencies>

3. 清理本地仓库无效缓存 #

删除本地.m2/repository/com/sample/${revision}目录，避免Maven读取无效的缓存文件：

rm -rf ~/.m2/repository/com/sample/\${revision}

Windows系统请手动定位到对应目录删除。

验证解决效果 #

执行以下命令重新构建项目：

mvn clean install

此时所有模块的依赖版本会被正确解析为1.1.0，不会再出现查找${revision}版本的错误。

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