Jenkins Multibranch Pipeline Webhook触发构建时如何解析payload

• 放弃双webhook的实现思路，这套逻辑本身走不通：多分支流水线的触发流程是webhook触发分支扫描 -> 匹配到变更的PR/分支 -> 自动创建构建任务，单独发的第二个webhook无法和扫描生成的构建任务绑定上下文，自然没法传参。
• 所有主流代码托管平台的多分支流水线插件，在触发PR构建时本身就会把完整webhook payload绑定到构建上下文里，不需要额外传参，只需要在Pipeline里直接读取即可：
  • 前置依赖：确保已经安装对应代码平台的Jenkins插件，比如GitHub源装GitHub Pipeline插件，GitLab源装GitLab Plugin，Gitea/Gogs同理安装对应官方插件。
  • GitHub源PR构建读取示例，直接在Jenkinsfile里通过build cause拿PR信息：

pipeline {
    agent any
    stages {
        stage('Load PR Metadata') {
            steps {
                script {
                    def prTriggerCause = currentBuild.rawBuild.getCause(org.jenkinsci.plugins.github.pullrequest.GitHubPRCause)
                    if (prTriggerCause) {
                        // 按需提取字段存为全局环境变量，后续所有构建步骤、后置脚本都能直接调用
                        env.PR_NUM = prTriggerCause.getNumber()
                        env.PR_TITLE = prTriggerCause.getTitle()
                        env.PR_FROM_BRANCH = prTriggerCause.getSourceBranch()
                        env.PR_TO_BRANCH = prTriggerCause.getTargetBranch()
                        env.PR_SUBMITTER = prTriggerCause.getPullRequestUserLogin()
                        env.PR_LINK = prTriggerCause.getUrl()
                        // 需要完整payload直接调用getPayload()方法即可拿到Map结构的全量数据
                        def fullWebhookPayload = prTriggerCause.getPayload()
                    }
                }
            }
        }
        stage('Post Build Auto Script') {
            steps {
                // 直接引用前面存的环境变量即可，不用额外传参
                sh 'your_deploy_script.sh --pr-id ${PR_NUM} --pr-url ${PR_LINK}'
            }
        }
    }
}

• GitLab源PR构建只需要替换cause类为com.dabsquared.gitlabjenkins.cause.GitLabWebHookCause，调用getHookPayload()方法就能拿到完整payload，PR编号、标题等字段都在payload的object_attributes节点下，按需提取即可。
• 通用兜底方案：如果用的是小众代码平台，没有对应插件封装cause读取方法，可以直接在多分支流水线的「构建策略」配置中，找到PR触发规则的配置项，勾选注入webhook payload到构建环境变量，开启后构建过程中会自动生成WEBHOOK_PAYLOAD环境变量，值为完整payload的JSON字符串，直接在shell脚本里用jq解析需要的字段即可，示例：

# 从环境变量里解析PR编号
PR_NUMBER=$(echo $WEBHOOK_PAYLOAD | jq -r '.pull_request.number')
PR_TITLE=$(echo $WEBHOOK_PAYLOAD | jq -r '.pull_request.title')

• 注意不要在流水线里随意开启rawBuild的全量权限，只需要给Jenkins运行账号授予Job/Read、Build/Read的最小权限即可满足读取cause的需求，不会有安全风险。

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