Maven Release Plugin读取settings文件路径错误问题排查

以下是可能导致该错误路径出现的几个关键点，按优先级排查：

1. Release插件的forked子进程未继承--settings参数 #

maven-release-plugin在执行release:prepare时会启动独立的Maven子进程完成部分操作，默认不会自动传递命令行中的--settings参数到子进程。如果子进程仍尝试读取旧的全局设置路径，就会触发该错误。

解决方法：在项目pom.xml中显式配置插件的arguments参数，强制传递settings路径：

<plugin>
  <groupId>org.apache.maven.plugins</groupId>
  <artifactId>maven-release-plugin</artifactId>
  <version>3.0.0-M7</version>
  <configuration>
    <arguments>--settings /F/.m2/settings.xml</arguments>
  </configuration>
</plugin>

2. 指定的settings.xml存在错误配置 #

检查你通过--settings指定的/F/.m2/settings.xml文件，确认是否存在以下问题：

• 错误使用<globalSettings>标签指向了仓库路径（如F:\f\.m2\repository），该标签应指向全局settings文件而非本地仓库；
• <localRepository>配置路径与错误路径存在关联，导致插件误将仓库路径识别为设置文件路径。

3. 系统环境变量残留旧配置 #

再次检查系统环境变量，确认是否存在MAVEN_GLOBAL_SETTINGS变量，若该变量被设置为F:\f\.m2\repository，会直接覆盖Maven默认的全局设置路径，引发错误。

4. Maven安装目录下的全局settings残留配置 #

检查Maven安装目录的conf/settings.xml文件，查看其中是否存在指向F:\f\.m2\repository的配置项，比如错误的<globalSettings>或其他相关路径配置。

5. IDE或构建工具的缓存 #

若你通过IDE执行命令，可能IDE缓存了旧的Maven配置路径。尝试清理IDE的Maven缓存（例如IntelliJ的"File → Invalidate Caches..."），重启后再执行命令。

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