Maven Deploy命令静默跳过部署问题排查求助

可能的触发原因 #

• 全局Maven配置强制跳过：settings.xml（用户目录.m2/或Maven安装目录conf/下）的<properties>或<profiles>中设置了maven.deploy.skip=true，全局配置优先级高于命令行参数。
• 父POM继承了跳过配置：当前项目若继承了父POM（比如公司统一的父依赖），父POM中可能定义了maven.deploy.skip=true，子项目会默认继承该属性。
• Jenkins环境注入了跳过参数：Jenkins的全局配置、流水线环境变量或节点配置里，可能通过MAVEN_OPTS等方式添加了-Dmaven.deploy.skip=true，覆盖了命令行参数。
• Deploy插件版本兼容问题：旧版本的maven-deploy-plugin对maven.deploy.skip参数的处理存在bug，导致命令行传入的false不生效。

对应的解决方案 #

• 检查并修正settings.xml：搜索两个位置的settings.xml中的maven.deploy.skip，若存在true配置，改为false或删除该配置项。
• 覆盖父POM的配置：在当前项目的pom.xml的<properties>中显式添加：

  <maven.deploy.skip>false</maven.deploy.skip>
  

  也可以执行mvn help:effective-pom生成生效的POM，确认是否有继承的跳过配置。
• 清理Jenkins环境参数：在流水线中添加步骤打印相关环境变量：

  sh 'printenv | grep -E "MAVEN|deploy"'
  

  检查是否存在含maven.deploy.skip=true的变量，同时排查Jenkins全局Maven配置的额外参数。
• 指定Deploy插件版本：在pom.xml中显式声明高版本插件（推荐3.1.0+）：

  <build>
      <plugins>
          <plugin>
              <groupId>org.apache.maven.plugins</groupId>
              <artifactId>maven-deploy-plugin</artifactId>
              <version>3.1.0</version>
          </plugin>
      </plugins>
  </build>
  

• 使用双重参数强制覆盖：执行命令时同时传入两个参数，确保覆盖所有可能的配置：

  mvn -X clean deploy -Dmaven.deploy.skip=false -Ddeploy.skip=false
  

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