求助：GitHub Webhook触发Jenkins多分支流水线构建所有分支而非目标分支

问题根源 #

你的多分支流水线触发所有分支的核心原因是共享库中重复配置了githubPush()触发器。多分支流水线（Multibranch Pipeline）本身依赖GitHub Branch Source插件监听Webhook，会自动触发推送分支的构建；但每个分支的pipeline里又单独配置了githubPush()，导致Jenkins收到Webhook后，会扫描所有分支的pipeline并触发全部构建。

修复步骤 #

1. 移除共享库中的冗余触发器

首先修改共享库的buildAndUploadToS3方法，删除triggers { githubPush() }块——多分支流水线的触发逻辑由Jenkins项目配置的GitHub Branch Source管理，不需要在pipeline脚本中重复定义。

2. 添加分支校验逻辑（可选但推荐）

在流水线中添加分支校验，确保只有指定分支（main/stage/live）能执行构建，同时验证构建是否由GitHub推送触发。修改后的共享库方法代码如下：

def call(String configFilename, Number retainedBuilds = 3) {
    pipeline {
        agent any
        options {
            disableConcurrentBuilds()
            buildDiscarder(logRotator(numToKeepString: "${retainedBuilds}", artifactNumToKeepStr: "${retainedBuilds}"))
        }
        stages {
            stage('Validate Trigger Context') {
                steps {
                    script {
                        // 限定允许构建的分支列表
                        def allowedBranches = ['main', 'stage', 'live']
                        def currentBranch = env.BRANCH_NAME

                        if (!allowedBranches.contains(currentBranch)) {
                            error "分支 ${currentBranch} 不在允许构建列表中，终止构建"
                        }

                        // 可选：仅允许GitHub推送触发构建，禁止手动触发
                        def isGitHubPush = currentBuild.buildCauses.any { cause ->
                            cause._class == 'hudson.plugins.git.GitHubPushCause'
                        }
                        if (!isGitHubPush) {
                            error "仅允许GitHub推送触发构建，当前构建为手动触发，终止"
                        }
                    }
                }
            }
            stage('Build & Deploy') {
                steps {
                    script {
                        // 读取项目配置文件
                        def config = readJSON file: configFilename
                        echo "开始从分支 ${env.BRANCH_NAME} 部署到 ${config.environment} 环境"
                        // 这里写入你的构建/部署逻辑
                    }
                }
            }
        }
    }
}

3. 确认Jenkins项目配置

进入你的多分支流水线项目配置页面，确保：

• GitHub Branch Source已正确配置仓库地址和凭据
• 勾选"Build when a change is pushed to GitHub"（或确认GitHub Webhook已指向该项目的回调URL）
• 分支过滤规则仅包含main/stage/live（避免无关分支被扫描）

为什么之前手动包裹pipeline报错？ #

共享库的buildAndUploadToS3方法已经返回了完整的pipeline块，因此Jenkinsfile中不能再嵌套pipeline，直接调用方法即可（保持原Jenkinsfile的buildAndUploadToS3('config.json', 5)写法即可）。

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