maven父子项目版本差异化管理可能导致依赖解析问题。本教程详细讲解了当子项目版本与父项目不同时，如何正确配置依赖。核心解决方案是在子项目中，对于继承自父项目的依赖，明确使用${project.parent.version}来指定其版本，从而避免cannot resolve错误，确保项目顺利构建和运行。
在Maven多模块项目中，父项目通常负责统一管理子项目的版本和依赖。然而，在某些场景下，我们可能需要让子项目拥有独立于父项目的版本号，例如，当子项目有独立的发布周期或需要更频繁地迭代时。此时，如果处理不当，可能会遇到依赖解析失败的问题，常见的错误提示是Cannot resolve。
问题描述与根源分析
默认情况下，Maven子项目会继承父项目的版本。当我们在子项目的pom.xml中显式定义一个不同于父项目的
父项目 pom.xml 示例 (部分)
<groupId>io.parent-test</groupId> <artifactId>io.parent-test</artifactId> <version>0.9.1-SNAPSHOT</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>此时，如果子项目中的某个依赖项，例如一个由父项目提供的内部库，其版本被定义为${project.version}，就会出现问题：
<dependency>
<groupId>io.parent-dep</groupId>
<artifactId>parent-dev</artifactId>
<version>${project.version}</version> <!-- 导致问题的原因 -->
</dependency>这里的核心问题在于${project.version}这个Maven变量的解析范围。当它出现在子项目的pom.xml中时，它会解析为当前子项目的版本（即0.9.2-SNAPSHOT）。然而，如果io.parent-dep:parent-dev这个依赖实际上是与父项目版本（0.9.1-SNAPSHOT）同步发布的，那么Maven将尝试查找io.parent-dep:parent-dev:0.9.2-SNAPSHOT，而这个版本可能并不存在，从而导致Cannot resolve错误。
解决方案：明确指定父项目版本
解决此问题的关键在于，对于那些应该与父项目版本保持一致的依赖项，在子项目中明确引用父项目的版本号，而不是子项目自身的版本号。Maven为此提供了一个特殊的变量：${project.parent.version}。
${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>通过上述修改，当Maven解析parent-dev依赖时，它会查找io.parent-dep:parent-dev:0.9.1-SNAPSHOT（即父项目的版本），从而成功解析依赖。
实施步骤与注意事项
-
确定需要独立版本的子项目： 在子项目的pom.xml中，在
标签之后，添加或修改 标签，指定子项目独立的版本号。 <!-- ... 省略父项目配置 ... --> <version>0.9.2-SNAPSHOT</version> <!-- 子项目独立版本 --> <artifactId>your-child-artifact</artifactId> <!-- ... -->
识别父项目相关的依赖： 检查子项目中所有依赖项。对于那些由父项目提供、或者其版本应该与父项目版本保持一致的依赖（例如，内部组件库、父项目定义的BOM中的依赖等），需要特别处理。
-
使用${project.parent.version}指定版本： 对于识别出的父项目相关依赖，将其
标签的值从${project.version}（如果之前是这样）修改为${project.parent.version}。 <dependencies> <dependency> <groupId>your.group.id</groupId> <artifactId>parent-related-dependency</artifactId> <version>${project.parent.version}</version> <!-- 关键修改 --> </dependency> <!-- 其他依赖，如果它们应与子项目自身版本同步，则仍可使用 ${project.version} 或固定版本号 --> </dependencies>
注意事项：
-
何时使用 ${project.version} vs. ${project.parent.version}：
- ${project.version}： 用于表示当前模块（即子项目自身）的版本。如果某个依赖的版本应该与子项目的发布周期一致，或者该依赖是子项目自身发布的一个内部模块，则可以使用此变量。
- ${project.parent.version}： 用于表示当前子项目所继承的父项目的版本。这适用于那些与父项目紧密关联、由父项目统一管理或发布的依赖。
-
revision 属性的替代方案：
在某些场景下，为了在多模块项目中统一管理所有模块的版本，父项目会定义一个
属性（例如 1.0.0-SNAPSHOT ${revision} 。这种方法适用于所有子项目都共享相同版本的情况。但如果目标是让某个特定子项目拥有独立于父项目的版本，并同时正确解析父项目依赖，那么本教程中的${project.parent.version}方案更为直接和适用。 - 依赖管理（Dependency Management）： 为了更好地管理依赖版本，推荐在父项目的dependencyManagement部分声明所有公共依赖的版本。子项目在引用这些依赖时，只需指定groupId和artifactId，无需指定version，Maven会自动从父项目的dependencyManagement中继承版本。即使子项目有独立版本，这种方式也能有效避免版本冲突和手动维护的复杂性。
总结
通过在Maven子项目中，针对父项目相关的依赖明确使用${project.parent.version}来指定版本，可以有效地解决子项目拥有独立版本时可能出现的依赖解析问题。理解${project.version}和${project.parent.version}之间的区别及其适用场景，是构建健壮、灵活的Maven多模块项目的关键。遵循这些实践，可以确保项目的各个模块在拥有独立发布能力的同时，也能保持正确的依赖关系。
