如何让Jenkins构建结果同步至Bitbucket Server的PR与分支？

我之前刚帮团队搞定过Jenkins和自托管Bitbucket Server的PR状态同步，正好能给你一步步讲清楚怎么做！核心是靠官方插件打通两者，再配合流水线配置，具体步骤如下：

首先得给Jenkins装上两个关键插件，别装错成Bitbucket Cloud的版本：

• Bitbucket Server Integration Plugin：专门对接自托管Bitbucket Server的官方插件，负责双向通信
• Pipeline Plugin：如果你们用流水线（现在大部分团队都用这个），这个是基础；如果用Freestyle项目可以忽略，但还是推荐流水线更灵活

Bitbucket Server这边不需要额外装插件，它原生支持接收外部构建状态的Webhook。

这一步是让两个系统互相认可，避免权限问题：

• 登录Bitbucket Server，进入管理员设置 → 应用链接
• 点击创建链接，输入Jenkins的完整访问URL（比如http://your-jenkins-host:8080），选择Generic Application类型
• 下一步选OAuth认证方式（最安全可靠）：
  • 切换到Jenkins，进入系统管理 → 系统设置，找到Bitbucket Server的配置板块，生成OAuth消费者密钥和密钥
  • 把这两个值填回Bitbucket Server的应用链接配置里，完成双向认证，确保链接状态显示正常

要实现PR创建/更新时自动触发构建，得给Jenkins项目加触发器：

• 新建或编辑你的Jenkins项目（推荐流水线项目）
• 在触发器部分，勾选Bitbucket Server trigger for pull requests
• 可以自定义触发条件：比如PR打开、更新、重新打开时触发，按需选择

这一步是让Jenkins把构建结果推回Bitbucket Server的PR上：
如果是流水线项目，直接在Jenkinsfile的post阶段添加状态通知步骤：

pipeline {
    agent any
    stages {
        stage('代码编译') {
            steps {
                sh 'mvn clean compile' // 替换成你们的编译命令
            }
        }
        stage('自动化测试') {
            steps {
                sh 'mvn test' // 替换成你们的测试命令
            }
        }
    }
    post {
        success {
            bitbucketStatusNotify(buildState: 'SUCCESSFUL', buildDescription: '构建和测试全部通过！')
        }
        failure {
            bitbucketStatusNotify(buildState: 'FAILED', buildDescription: '构建或测试失败，请查看Jenkins日志排查！')
        }
        unstable {
            bitbucketStatusNotify(buildState: 'INPROGRESS', buildDescription: '构建完成但存在不稳定测试项！')
        }
    }
}

• 提示：bitbucketStatusNotify是Bitbucket Server Integration Plugin自带的步骤，不需要额外配置PR信息，插件会自动识别当前触发构建的PR

如果是Freestyle项目，就在构建后操作里添加Notify Bitbucket Server步骤，选择对应的构建状态和描述即可。

• 在Bitbucket Server上创建一个新PR，或者更新现有PR的代码
• 观察Jenkins是否自动触发对应构建
• 构建完成后回到PR页面，在PR顶部的状态栏或者活动标签里，就能看到Jenkins的构建状态标记（绿色成功、红色失败）

• 确保Jenkins和Bitbucket Server之间网络互通，没有防火墙拦截
• 可以在Bitbucket Server的PR设置里，把Jenkins构建状态设为合并前置条件，强制只有构建通过的PR才能合并，规范团队流程

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