Maven SCM插件相对路径异常：release:prepare执行报错求解决方案

这个问题我之前帮同事处理过，本质是Maven Release插件在父pom不在项目根目录的场景下，错误地将父pom所在目录作为路径基准，导致拼接出了不存在的文件路径。以下是几个不需要修改父pom位置的解决方案：

方案1：命令行指定工作目录 #

执行release:prepare时，直接通过参数指定插件使用项目根目录作为工作目录，这样它就能正确解析文件路径了：

# 如果在parent目录下执行命令
mvn release:prepare -DworkingDirectory=${project.basedir}/..

# 如果在项目根目录下执行（指定父pom）
mvn -f parent/pom.xml release:prepare -DworkingDirectory=.

方案2：在父pom中配置固定工作目录 #

不想每次加命令行参数的话，可以在父pom的maven-release-plugin配置里直接固定工作目录：

<build>
  <plugins>
    <plugin>
      <groupId>org.apache.maven.plugins</groupId>
      <artifactId>maven-release-plugin</artifactId>
      <!-- 建议升级到3.0.x及以上的稳定版本，避免旧版本的路径bug -->
      <version>3.0.1</version>
      <configuration>
        <!-- 相对于父pom的位置，指向项目根目录 -->
        <workingDirectory>${project.basedir}/..</workingDirectory>
      </configuration>
    </plugin>
  </plugins>
</build>

方案3：显式指定需要包含的额外文件 #

如果插件是自动检测到未提交的addme.product但路径解析错误，你可以在插件配置里显式列出该文件的正确相对路径（相对于父pom的位置）：

<plugin>
  <groupId>org.apache.maven.plugins</groupId>
  <artifactId>maven-release-plugin</artifactId>
  <version>3.0.1</version>
  <configuration>
    <additionalFiles>
      <!-- 从parent目录到根目录的addme.product的相对路径 -->
      <additionalFile>../addme.product</additionalFile>
    </additionalFiles>
  </configuration>
</plugin>

方案4：升级Release插件版本 #

旧版本的maven-release-plugin存在路径解析的bug，尤其是在处理非标准目录结构时。升级到最新的稳定版本（比如3.0.x及以上），很多这类路径问题会被官方修复。

额外检查：确保SCM配置正确 #

还要确认父pom中的SCM配置指向的是项目根目录的Git仓库，避免插件从错误的仓库路径解析文件：

<scm>
  <connection>scm:git:file:///${project.basedir}/../.git</connection>
  <developerConnection>scm:git:file:///${project.basedir}/../.git</developerConnection>
  <url>https://your-git-repo-url.git</url>
</scm>

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