Maven构建时错误选用maven-release-plugin版本的问题咨询

我在父pom.xml的pluginManagement里明确指定了maven-release-plugin使用2.5.3版本，但执行Maven构建时，系统却自动拉取并使用了2.2.2版本，以下是排查和解决的具体思路：

我的配置与现象 #

父POM中pluginManagement的插件配置片段：

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-release-plugin</artifactId>
    <version>2.5.3</version> 
    <dependencies>
        <dependency>
            <groupId>org.apache.maven.scm</groupId>
            <artifactId>maven-scm-provider-gitexe</artifactId>
            <version>1.9.4</version>
        </dependency>
    </dependencies>
</plugin>

构建时的实际下载日志：

Downloading: https://pkgs.dev.azure.com/*removed*/maven/v1/org/apache/maven/plugins/maven-release-plugin/2.2.2/maven-release-plugin-2.2.2.pom

排查方向与解决步骤 #

• 检查子POM的直接配置：所有子模块的pom.xml中，如果直接声明了maven-release-plugin并指定了2.2.2版本，会直接覆盖父POM的pluginManagement配置。找到后可删除子POM中的版本声明（继承父POM版本），或统一改为2.5.3。

• 排查依赖传递引入：部分其他插件可能间接依赖了旧版本的maven-release-plugin。执行以下命令生成依赖树，定位旧版本的来源：

  mvn dependency:tree -Dverbose -Dincludes=org.apache.maven.plugins:maven-release-plugin
  

  找到来源后，可在父POM的插件依赖中排除旧版本，或调整相关插件的版本。

• 检查全局settings配置：查看Maven全局配置文件settings.xml，确认是否在profiles或pluginGroups中指定了该插件的版本，全局配置优先级会覆盖项目POM的定义。

• 清理本地仓库缓存：本地Maven仓库可能缓存了旧版本插件，或缓存文件损坏。删除本地仓库中对应目录：

  ~/.m2/repository/org/apache/maven/plugins/maven-release-plugin/2.2.2
  

  重新执行构建，让Maven重新下载指定的2.5.3版本。

• 确认pluginManagement生效：检查父POM的pluginManagement是否存在语法错误，子POM的<parent>节点配置是否正确。子POM中使用该插件时，无需重复指定版本，仅声明groupId和artifactId即可自动继承父POM版本：

  <build>
      <plugins>
          <plugin>
              <groupId>org.apache.maven.plugins</groupId>
              <artifactId>maven-release-plugin</artifactId>
          </plugin>
      </plugins>
  </build>
  

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