Maven deploy:deploy-file的skip参数无法正确识别快照与正式版本

核心问题 #

你遇到的问题根源是maven-deploy-plugin的deploy-file目标配置错误——错误使用了<skip>releases</skip>/<skip>snapshots</skip>这类无效参数，导致插件无法正确根据版本类型（SNAPSHOT/RELEASE）判断跳过哪个执行流程。

错误配置分析 #

maven-deploy-plugin的deploy-file目标并没有接受releases/snapshots作为值的<skip>参数，而是通过两个独立的布尔参数实现版本过滤：

• <skipReleases>：设为true时，跳过正式版本部署（仅处理SNAPSHOT版本）
• <skipSnapshots>：设为true时，跳过快照版本部署（仅处理RELEASE版本）

你的原有配置逻辑错误，导致插件无法识别当前版本为SNAPSHOT，错误触发了正式仓库的部署流程，进而触发仓库的400校验错误。

修正后的配置示例 #

针对自定义生成的pom.xml，正确配置两个deploy-file执行如下：

<plugin>
  <groupId>org.apache.maven.plugins</groupId>
  <artifactId>maven-deploy-plugin</artifactId>
  <version>3.1.1</version>
  <executions>
    <!-- 部署快照版本到快照仓库 -->
    <execution>
      <id>deploy-custom-bom-snapshot</id>
      <phase>deploy</phase>
      <goals>
        <goal>deploy-file</goal>
      </goals>
      <configuration>
        <!-- 指定自定义生成的pom文件路径 -->
        <file>${project.build.directory}/my-custom-bom/pom.xml</file>
        <!-- 快照仓库ID（对应settings.xml中的配置） -->
        <repositoryId>snapshot-repository</repositoryId>
        <url>https://your-snapshot-repo-url</url>
        <!-- 跳过正式版本，仅部署SNAPSHOT -->
        <skipReleases>true</skipReleases>
        <!-- 快照版本启用时间戳命名（Maven默认值，可根据仓库规则调整） -->
        <uniqueVersion>true</uniqueVersion>
      </configuration>
    </execution>

    <!-- 部署正式版本到正式仓库 -->
    <execution>
      <id>deploy-custom-bom-release</id>
      <phase>deploy</phase>
      <goals>
        <goal>deploy-file</goal>
      </goals>
      <configuration>
        <file>${project.build.directory}/my-custom-bom/pom.xml</file>
        <repositoryId>release-repository</repositoryId>
        <url>https://your-release-repo-url</url>
        <!-- 跳过快照版本，仅部署RELEASE -->
        <skipSnapshots>true</skipSnapshots>
      </configuration>
    </execution>
  </executions>
</plugin>

额外注意事项 #

1. 确认自定义pom版本正确性：检查生成的target/my-custom-bom/pom.xml中的<version>确实包含-SNAPSHOT后缀，插件会自动读取该版本判断类型。
2. uniqueVersion参数调整：如果你的快照仓库要求不带时间戳的版本（不推荐），可将<uniqueVersion>设为false，但这可能导致仓库覆盖旧快照，需严格遵循仓库规则。
3. 阶段绑定合理性：将两个执行都绑定到deploy阶段，Maven会自动根据当前版本类型跳过不符合的执行流程。

内容的提问来源于stack exchange，提问作者B. Meert