本文旨在解决maven父子项目版本不一致时，子项目依赖解析失败的问题。核心解决方案在于明确区分子项目自身的版本（`${project.version}`）与父项目的版本（`${project.parent.version}`）。通过在子项目的依赖配置中，将需要继承父版本号的依赖显式指定为`${project.parent.version}`，即可确保依赖正确解析，同时允许子项目拥有独立的版本号。
理解Maven父子项目版本管理
在Maven多模块项目中，父项目通常负责聚合和管理子项目，并提供统一的配置，包括依赖管理、插件配置等。默认情况下，子项目会继承父项目的版本。然而，在某些场景下，我们可能希望子项目拥有独立的版本号，例如当子项目有独立的发布周期或需要进行独立迭代时。
当尝试为子项目设置一个与父项目不同的版本时，常见的错误是依赖解析失败，尤其是那些在子项目中声明时使用了${project.version}作为版本占位符的依赖。这是因为在子项目的pom.xml中，${project.version}会解析为子项目自身的版本，而非其父项目的版本。
考虑以下Maven父子项目结构示例：
父项目 pom.xml 片段：
<modelVersion>4.0.0</modelVersion>
<groupId>io.parent-test</groupId>
<artifactId>io.parent-test</artifactId>
<version>0.9.1-SNAPSHOT</version>
<packaging>pom</packaging> <!-- 父项目通常为pom类型 -->
<name>Parent Test Project</name>
<modules>
<module>test-project-converter</module>
</modules>
<dependencyManagement>
<dependencies>
<dependency>
<groupId>io.parent-dep</groupId>
<artifactId>parent-dev</artifactId>
<version>${project.version}</version> <!-- 注意这里使用了父项目的版本 -->
</dependency>
</dependencies>
</dependencyManagement>子项目 pom.xml 片段（初始工作状态）：
<modelVersion>4.0.0</modelVersion>
<parent>
<groupId>io.parent-test</groupId>
<artifactId>io.parent-test</artifactId>
<version>0.9.1-SNAPSHOT</version>
<relativePath></relativePath>
</parent>
<artifactId>test-project-converter</artifactId>
<!-- 此时子项目隐式继承父项目版本 0.9.1-SNAPSHOT -->
<name>test-project</name>
<description>Test Project</description>
<dependencies>
<dependency>
<groupId>io.parent-dep</groupId>
<artifactId>parent-dev</artifactId>
<!-- 此时 ${project.version} 解析为 0.9.1-SNAPSHOT，因为子项目继承了父版本 -->
<version>${project.version}</version>
</dependency>
</dependencies>在这种情况下，子项目的${project.version}会解析为父项目的版本0.9.1-SNAPSHOT，依赖能够正确解析。
引入子项目独立版本后的问题
当尝试为子项目指定一个不同的版本时，例如将其版本设置为0.9.2-SNAPSHOT：
子项目 pom.xml 片段（引入独立版本后）：
<modelVersion>4.0.0</modelVersion>
<parent>
<groupId>io.parent-test</groupId>
<artifactId>io.parent-test</artifactId>
<version>0.9.1-SNAPSHOT</version>
<relativePath></relativePath>
</parent>
<version>0.9.2-SNAPSHOT</version> <!-- 子项目独立版本 -->
<artifactId>test-project-converter</artifactId>
<name>test-project</name>
<description>Test Project</description>
<dependencies>
<dependency>
<groupId>io.parent-dep</groupId>
<artifactId>parent-dev</artifactId>
<!-- 问题所在：此时 ${project.version} 解析为 0.9.2-SNAPSHOT (子项目版本) -->
<version>${project.version}</version>
</dependency>
</dependencies>此时，如果io.parent-dep:parent-dev这个依赖实际上是与父项目0.9.1-SNAPSHOT版本绑定的，那么当子项目中的<version>${project.version}</version>解析为0.9.2-SNAPSHOT时，Maven将无法找到io.parent-dep:parent-dev:0.9.2-SNAPSHOT这个依赖，从而导致Cannot resolve错误。
解决方案：显式引用父项目版本
解决此问题的关键在于，当子项目需要使用父项目定义的依赖版本时，应显式地引用父项目的版本号，而不是子项目自身的版本号。Maven提供了${project.parent.version}这个内置属性，它始终指向当前项目的父项目的版本。
子项目 pom.xml 片段（修正后）：
<modelVersion>4.0.0</modelVersion>
<parent>
<groupId>io.parent-test</groupId>
<artifactId>io.parent-test</artifactId>
<version>0.9.1-SNAPSHOT</version>
<relativePath></relativePath>
</parent>
<version>0.9.2-SNAPSHOT</version> <!-- 子项目独立版本 -->
<artifactId>test-project-converter</artifactId>
<name>test-project</name>
<description>Test Project</description>
<dependencies>
<dependency>
<groupId>io.parent-dep</groupId>
<artifactId>parent-dev</artifactId>
<!-- 修正：显式引用父项目的版本 -->
<version>${project.parent.version}</version>
</dependency>
</dependencies>通过将依赖的版本指定为${project.parent.version}，即使子项目拥有独立的版本0.9.2-SNAPSHOT，io.parent-dep:parent-dev这个依赖也会正确地解析为0.9.1-SNAPSHOT，从而避免了依赖解析错误。
注意事项与最佳实践
-
明确版本引用：
- ${project.version}：始终指代当前项目（即当前pom.xml文件所在的项目）的版本。
- ${project.parent.version}：始终指代当前项目的父项目的版本。
- 在使用版本占位符时，务必清楚你希望引用的是哪个项目的版本。
-
依赖管理（dependencyManagement）： 对于大型多模块项目，最佳实践是在父项目的dependencyManagement部分统一声明所有依赖的版本。子项目在引用这些依赖时，只需声明groupId和artifactId，无需再指定version。这样可以确保所有子项目使用的依赖版本一致，并且易于管理。
父项目 pom.xml 中配置 dependencyManagement：
<dependencyManagement> <dependencies> <dependency> <groupId>io.parent-dep</groupId> <artifactId>parent-dev</artifactId> <version>0.9.1-SNAPSHOT</version> <!-- 或 ${project.version} 如果 parent-dev 版本与父项目版本一致 --> </dependency> <!-- 其他统一管理的依赖 --> </dependencies> </dependencyManagement>子项目 pom.xml 中引用依赖（不指定版本）：
<dependencies> <dependency> <groupId>io.parent-dep</groupId> <artifactId>parent-dev</artifactId> <!-- 版本由父项目的 dependencyManagement 提供 --> </dependency> </dependencies>即使子项目有自己的独立版本，通过dependencyManagement引入的依赖版本仍然由父项目控制，这是一种更推荐的做法。如果parent-dev的版本确实需要与父项目版本保持一致，那么在dependencyManagement中直接使用${project.version}（此时指父项目的版本）也是可行的。
何时使用独立版本： 通常，当子项目具有独立的发布周期，或者其开发进度与父项目及其他兄弟子项目不完全同步时，才考虑为其设置独立版本。否则，为了简化管理，建议子项目继承父项目的版本。
总结
当Maven子项目需要拥有独立于父项目的版本号时，核心在于理解Maven版本属性的解析规则。对于那些期望与父项目版本保持一致的依赖，务必在子项目中显式使用${project.parent.version}来引用父项目的版本，而不是默认的${project.version}。结合dependencyManagement的使用，可以更有效地管理多模块项目的依赖版本，确保项目构建的稳定性和一致性。
