如何限制父POM中${project.version}的作用域仅为父项目？

Maven中，${project.version}是上下文相关变量——子项目继承父POM时，父POM里所有该变量的引用都会被子项目的版本值替换，这就是你遇到问题的根源。无法直接限制${project.version}的作用域仅为父项目，但可以通过以下方案实现需求：

方案：在父POM中定义专属版本属性 #

在父POM里新增一个属性存储自身版本，让这个属性自动关联到父POM的${project.version}，然后在依赖管理中使用这个专属属性。这样既能保证父POM的依赖用自身版本，子项目的${project.version}依然指向自身版本，且升级父POM时只需修改一处版本号。

父POM示例 #

<project>
  <modelVersion>4.0.0</modelVersion>
  <groupId>com.example</groupId>
  <artifactId>parent-pom</artifactId>
  <!-- 只需修改这里的版本，属性会自动同步 -->
  <version>1.2.3</version>
  <packaging>pom</packaging>

  <properties>
    <!-- 专属属性存储父POM版本，自动绑定到自身的project.version -->
    <parent.pom.version>${project.version}</parent.pom.version>
  </properties>

  <dependencyManagement>
    <dependencies>
      <!-- 依赖管理中使用父专属属性，确保版本为父POM的版本 -->
      <dependency>
        <groupId>com.example</groupId>
        <artifactId>common-lib</artifactId>
        <version>${parent.pom.version}</version>
      </dependency>
    </dependencies>
  </dependencyManagement>
</project>

子项目POM示例 #

<project>
  <parent>
    <groupId>com.example</groupId>
    <artifactId>parent-pom</artifactId>
    <version>1.2.3</version>
  </parent>
  <modelVersion>4.0.0</modelVersion>
  <artifactId>child-project</artifactId>
  <!-- 子项目自身版本，不影响父POM的依赖版本 -->
  <version>2.0.0</version>

  <dependencies>
    <!-- 子项目内使用${project.version}依然指向自身版本 -->
    <dependency>
      <groupId>com.example</groupId>
      <artifactId>child-module</artifactId>
      <version>${project.version}</version>
    </dependency>
    <!-- 从父依赖管理继承的common-lib版本为1.2.3，而非子项目的2.0.0 -->
    <dependency>
      <groupId>com.example</groupId>
      <artifactId>common-lib</artifactId>
    </dependency>
  </dependencies>
</project>

方案优势 #

• 升级父POM时，仅需修改父POM的<version>标签，专属属性会自动同步，无需手动修改两处版本号；
• 父POM的依赖管理始终使用自身版本，子项目的${project.version}不受影响，依然指向子项目版本；
• 完全符合Maven的继承机制，无hack性质操作，兼容性好。

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