如何在Pull Request合并事件触发Jenkins构建并忽略特定用户提交

我最近刚啃完这个需求，折腾了快一周，太懂那种找不到清晰实操指引的抓狂了！刚好把我踩过的坑和整理出来的步骤分享给你，帮你少浪费时间在琐碎细节上。

1. 先搞定PR合并触发Jenkins构建的基础配置 #

首先得确保你的Jenkins和代码托管平台（GitHub/GitLab/其他）打通，核心是Webhook+触发器配置：

• 步骤1：安装对应SCM插件：比如用GitHub就装「GitHub Integration Plugin」，GitLab就装「GitLab Plugin」，尽量选最新版，避免兼容性问题
• 步骤2：配置项目的源代码管理：进入Jenkins项目的「配置」页面，找到「源代码管理」模块，选择你的托管平台，填好仓库地址，配置好有权限的凭证（比如个人AccessToken）
• 步骤3：设置构建触发器：在「构建触发器」模块，勾选对应的PR合并触发选项：
  • GitHub：勾选「GitHub hook trigger for GITScm polling」
  • GitLab：勾选「Build when a merge request is accepted」
• 步骤4：在代码托管平台配置Webhook：
  • 仓库设置里找到Webhook选项，添加Jenkins的Webhook地址：GitHub是http://你的Jenkins地址/github-webhook/，GitLab是http://你的Jenkins地址/project/项目名称
  • 事件类型只勾选「Pull Request 合并」相关的选项（比如GitHub选「Pull requests」里的「Closed」并勾选「Only send events when a pull request's merge state changes」），避免无关事件触发构建

2. 添加忽略特定用户提交的逻辑 #

这里有两种方式，我更推荐用Jenkinsfile，灵活性更高，也方便团队统一维护：

方式一：Jenkinsfile里判断提交者并跳过构建 #

在你的项目Jenkinsfile开头加一个校验阶段，获取提交者信息，匹配到忽略列表就终止构建：

pipeline {
    agent any
    stages {
        stage('校验提交者') {
            steps {
                script {
                    // 获取PR合并后最新提交的作者名称（如果需要邮箱就用%ce替换%an）
                    def committerName = sh(script: 'git log --pretty=format:"%an" -n 1', returnStdout: true).trim()
                    // 定义要忽略的用户列表，比如CI机器人、自动化账号
                    def ignoredCommitters = ['auto-deploy-bot', 'ci-system-user']
                    
                    if (ignoredCommitters.contains(committerName)) {
                        echo "⚠️ 检测到忽略用户 ${committerName} 的提交，跳过本次构建"
                        currentBuild.result = 'ABORTED'
                        return // 终止后续阶段执行
                    }
                }
            }
        }
        // 下面是你的正常构建、测试、部署步骤
        stage('构建项目') {
            steps {
                echo '开始执行构建...'
                sh 'mvn clean package -DskipTests' // 替换成你的构建命令
            }
        }
    }
}

⚠️ 注意：有些平台合并PR时，提交者可能是平台的官方bot（比如GitHub的github-actions[bot]），如果这类提交也需要忽略，记得把它加入列表。

方式二：用Jenkins插件快速过滤（适合简单场景） #

如果不想写代码，可以用「Build Blocker Plugin」：

• 先在Jenkins插件市场安装这个插件
• 进入项目配置，找到「Build Blocker」模块，勾选「Block build if certain strings are found in the commit messages or author names」
• 在「Block builds if author contains」里填要忽略的用户名，多个用逗号分隔
• 这种方式操作简单，但没法处理复杂逻辑（比如根据分支+用户组合判断），适合需求单一的场景

3. 测试验证必不可少 #

别光配置完就不管了，一定要验证：

• 用被忽略的用户提交PR并合并，查看Jenkins是否标记构建为「ABORTED」且跳过后续步骤
• 用普通用户提交PR合并，确认Jenkins正常触发完整构建流程
• 查看Jenkins的「控制台输出」和代码托管平台的Webhook日志，确保事件能正常传递

我当时踩过的坑：一开始没注意到GitHub合并PR时的提交者是bot，导致配置完还是会触发构建，后来把bot账号加入忽略列表才解决。

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