如何解决Jenkins向Nexus部署多POM文件时的报错问题

首先，咱们先明确问题场景和根源：你在Jenkins里配置了SIT、UAT、预生产三个独立的构建任务，完成三次构建后部署第二个任务时触发了Nexus的400错误，具体报错如下：

[ERROR] Failed to execute goal org.apache.maven.plugins:maven-deploy-plugin:2.8.2:deploy-file (default-cli) on project standalone-pom: Failed to deploy artifacts: Could not transfer artifact com.companyabc.app.apigee:template-app:pom:1.0 from/to maven-releases Failed to transfer file: http://[REDACTED]/template-app-1.0.pom. Return code is: 400, ReasonPhrase: Repository does not allow updating assets: maven-releases.

你推测的原因完全正确——Nexus的Releases仓库默认是不允许覆盖已存在的资产的，第一次构建已经上传了com.companyabc.app.apigee:template-app:pom:1.0这个POM，第二次再传同名同版本的就会被拦截。

下面针对你提出的两个方案，给你详细的Jenkins实现步骤，再补充几个可行的替代方案：

方案一：为三个构建任务设置不同的POM标识（版本/文件名） #

这个方案的核心是让每个环境的构建产物拥有唯一的身份，从根源上避免重复上传冲突，具体有两种实现方式：

方式1：在Jenkins任务中直接修改Maven命令的版本/artifactId #

针对每个Jenkins任务（SIT、UAT、预生产），调整deploy命令中的版本号或artifactId：

• SIT任务的Maven命令：

  mvn deploy:deploy-file -DgroupId=com.companyabc.app.apigee -DartifactId=template-app -Dversion=1.0-SIT -Dpackaging=pom -Dfile=path/to/your/pom.xml -Durl=http://[REDACTED] -DrepositoryId=maven-releases
  

• UAT任务把版本改成1.0-UAT，预生产用1.0（保持正式版本号）
• 如果不想改版本号，也可以修改artifactId：比如SIT用template-app-sit，UAT用template-app-uat，预生产保留template-app

方式2：通过环境变量动态注入POM的版本/标识 #

如果你的POM支持变量替换，可以在Jenkins中给每个任务设置专属环境变量，再传递到Maven中：

1. 给SIT任务设置环境变量ENV_TAG=SIT，UAT设为UAT，预生产设为PROD
2. 修改POM文件，把版本号改成带变量的形式：

   <version>1.0-${ENV_TAG}</version>
   

3. 在Jenkins的Maven命令中传递这个变量：

   mvn deploy:deploy-file -DENV_TAG=${ENV_TAG} -DgroupId=com.companyabc.app.apigee -DartifactId=template-app -Dpackaging=pom -Dfile=path/to/your/pom.xml -Durl=http://[REDACTED] -DrepositoryId=maven-releases
   

方案二：仅上传最后一个（预生产）构建的POM文件 #

这个方案适合三个任务是串行执行，且只需要预生产的POM进入Releases仓库的场景，实现方式分两种：

方式1：拆分构建与部署步骤（普通Freestyle任务） #

1. 给SIT和UAT任务的Maven命令只执行构建，跳过deploy：

   mvn clean install
   

   这样只会在Jenkins本地完成构建，不会向Nexus上传任何资产
2. 只有预生产任务执行完整的deploy命令，把POM上传到Releases仓库

方式2：用Jenkins Pipeline的条件判断控制部署 #

如果你的任务是Pipeline类型，可以直接在Jenkinsfile中加条件判断，只有预生产环境才触发deploy：

pipeline {
    agent any
    environment {
        ENV = "${params.ENVIRONMENT}" // 通过构建参数传递环境标识：SIT/UAT/PREPROD
    }
    stages {
        stage('Build Project') {
            steps {
                sh 'mvn clean install'
            }
        }
        stage('Deploy to Nexus Releases') {
            when {
                environment name: 'ENV', value: 'PREPROD'
            }
            steps {
                sh 'mvn deploy:deploy-file -DgroupId=com.companyabc.app.apigee -DartifactId=template-app -Dversion=1.0 -Dpackaging=pom -Dfile=path/to/pom.xml -Durl=http://[REDACTED] -DrepositoryId=maven-releases'
            }
        }
    }
}

执行时选择对应的环境参数，只有选PREPROD时才会执行部署步骤。

其他可行的替代方案 #

如果上面两个方案不适合你的场景，还有这些思路可以尝试：

• 用Nexus Snapshots仓库处理SIT/UAT：把SIT和UAT的构建产物上传到Snapshots仓库（默认允许覆盖），版本号加上-SNAPSHOT后缀（比如1.0-SNAPSHOT），只有预生产的产物上传到Releases仓库。只需要修改Maven命令中的-Durl为Snapshots仓库地址即可。
• 临时开启Nexus Releases仓库的覆盖权限：这个不推荐（因为Releases仓库的设计就是存储稳定不可变的版本），但如果是特殊场景需要，可以进入Nexus后台，找到maven-releases仓库的配置页面，把「Deployment Policy」改成「Allow Redeploy」。注意这个操作会破坏Releases仓库的不可变性，用完建议改回去。

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