Jenkins构建失败时如何自动拒绝Bitbucket中的Pull Request？

前置准备 #

• Jenkins端提前安装插件：Bitbucket Pull Request Builder 或 Bitbucket Integration 插件，以及用于调用接口的 HTTP Request 插件（如果用curl调用可不用安装）
• Bitbucket端创建具备PR管理权限的服务账号，生成对应的应用密码（Bitbucket Cloud场景）或个人访问令牌（PAT）（Bitbucket Server/Data Center场景），权限勾选PR编辑、拒绝相关的权限项。

步骤1：配置Jenkins任务获取PR基础参数 #

• 若使用Bitbucket Pull Request Builder插件触发构建，插件会自动注入pullRequestId（PR编号）、repoOwner、repoName等环境变量，无需额外配置
• 若使用Webhook手动触发构建，需要在Webhook请求参数中携带PR编号、目标仓库路径等信息，同时将Jenkins任务配置为参数化构建，对应接收上述参数。

注意：所有敏感信息（服务账号密码、令牌等）必须存储在Jenkins凭据管理中，禁止硬编码在任务配置里。

步骤2：添加构建失败后的PR拒绝逻辑 #

根据Jenkins任务类型选择对应配置方式：

自由式任务配置 #

1. 进入任务配置页，添加Post-build Action，选择「Execute shell」/「Execute Windows batch command」，勾选仅在构建失败时执行
2. 填入对应Bitbucket版本的API调用命令：
   • Bitbucket Cloud 示例命令：
     curl -X POST -u "服务账号用户名:应用密码" -H "Content-Type: application/json" https://api.bitbucket.org/2.0/repositories/{repoOwner}/{repoName}/pullrequests/{pullRequestId}/decline -d '{"reason":"Jenkins构建失败，请修复后重新提交PR"}'
   • Bitbucket Server 示例命令：
     curl -X POST -H "Authorization: Bearer 你的PAT令牌" -H "Content-Type: application/json" https://你的Bitbucket域名/rest/api/1.0/projects/{项目key}/repos/{仓库名}/pull-requests/{PR编号}/decline -d '{"version": 0, "comment": "Jenkins构建失败，请修复后重新提交PR"}'

   提示：Bitbucket Server接口中的version参数为PR当前版本号，可通过插件注入的环境变量或提前调用一次PR查询接口获取。

Pipeline任务配置 #

在Pipeline代码的post块中添加failure执行逻辑，示例如下：

pipeline {
  agent any
  stages {
    // 你的原有构建逻辑
    stage('Build') {
      steps {
        sh 'mvn clean install'
      }
    }
  }
  post {
    failure {
      // bitbucket-svc-account为你在Jenkins凭据中存储的Bitbucket服务账号凭据ID
      withCredentials([usernamePassword(credentialsId: 'bitbucket-svc-account', usernameVariable: 'BITBUCKET_USER', passwordVariable: 'BITBUCKET_PWD')]) {
        sh """
          curl -X POST -u "${BITBUCKET_USER}:${BITBUCKET_PWD}" -H "Content-Type: application/json" https://api.bitbucket.org/2.0/repositories/${repoOwner}/${repoName}/pullrequests/${pullRequestId}/decline -d '{"reason":"Jenkins构建失败，请修复后重新提交PR"}'
        """
      }
    }
  }
}

步骤3：配置Bitbucket合并限制（可选但推荐） #

为避免PR在Jenkins构建完成前被手动合并，可添加合并限制：

• 进入Bitbucket对应仓库的「仓库设置」-「分支权限」，给需要保护的目标分支（如main、develop）添加合并规则
• 勾选必须通过所有对应的构建检查才能合并，同时可配置仅允许服务账号操作PR的拒绝权限，避免普通用户误操作。

测试验证 #

• 提交一个明确会导致构建失败的PR，确认Jenkins触发构建后，构建失败时Bitbucket对应PR会被自动标记为已拒绝，且展示预设的拒绝理由
• 若配置不生效，查看Jenkins构建日志中的API调用返回值：403报错为服务账号权限不足，404报错为PR编号或仓库路径配置错误，根据错误提示调整对应配置即可。

内容的提问来源于stack exchange，提问作者Sonny Minh Vu