Jenkins pollSCM轮询触发器重复触发问题：每次提交触发至少两次构建

我之前帮不少团队排查过类似的Poll SCM重复构建问题，你遇到的是这个触发器的经典“逻辑坑”——核心是Jenkins的Poll机制和构建状态同步的逻辑冲突，下面给你拆解原因和对应的解决办法：

为什么会触发两次构建？ #

主要有两个关键原因：

• Poll时间戳的逻辑特性：Jenkins的Poll SCM是基于上次执行poll的时间点来对比SCM提交记录，而非上次构建完成的时间。比如你10:02提交代码，10:05第一次poll触发构建（上次poll基准时间是10:00）；第一次构建在10:07完成后，下一次poll在10:10，此时poll的基准时间更新为10:05，它会发现10:02的提交在10:05-10:10这个窗口里“没被poll过”，于是再次触发构建。
• 构建状态同步滞后：当首次构建还在运行时，Jenkins的SCM状态可能没及时更新到“该提交已被构建”，导致下一次poll时仍然判定这个提交是未处理的新提交。

具体解决方案 #

1. 用Webhook替代Poll SCM（最推荐） #

如果你的需求只是“代码提交时触发构建”，完全没必要用定时Poll——直接配置SCM的postCommit钩子（比如GitHub/GitLab的Webhook），这样只会在代码真正提交时触发一次构建，从根源避免重复问题：

properties([
    pipelineTriggers([
        // 以GitHub为例，替换成对应SCM的触发器
        githubPush()
    ])
])

不同SCM的触发器语法略有差异，比如GitLab可以用gitlabPush()，你可以根据自己的SCM类型调整。

2. 添加提交哈希检查，主动终止重复构建 #

如果必须保留定时Poll（比如还要检测外部依赖的SCM变动），可以在流水线开头添加检查逻辑，对比当前提交和上次成功构建的提交哈希，如果一致就直接终止构建：

properties([
 chronic water Ability构) tu尊 Evans费  /encoding巴的编码？不对，直接放代码：
properties([
    pipelineTriggers([
        pollSCM('H/5 * * * *')
    ])
])

pipeline {
    agent any
    stages {
        stage('防重复构建检查') {
            steps {
                script {
                    // 获取上次成功构建的commit哈希
                    def lastBuiltCommit = currentBuild.previousSuccessfulBuild?.getRawBuild()?.getScm()?.getLastBuiltRevision()?.getSha1String()
                    def currentCommit = sh(script: 'git rev-parse HEAD', returnStdout: true).trim()
                    
                    if (lastBuiltCommit && lastBuiltCommit == currentCommit) {
                        echo "当前提交 ${currentCommit} 已被成功构建过，终止本次流水线"
                        currentBuild.result = 'ABORTED'
                        return
                    }
                }
            }
        }
        // 你的其他业务阶段...
    }
}

这个方法不用改动Poll配置，只是在流水线内部做拦截，避免无效的重复构建执行。

3. 延长Poll间隔（被动方案） #

如果你的构建时长稳定短于5分钟，可以把Poll间隔调整为大于构建时长，比如H/10 * * * *（每10分钟poll一次）。这样第一次构建完成后，Jenkins有足够时间同步构建状态，下一次Poll时就不会认为提交是新的了。不过这个方法依赖构建时长的稳定性，不太推荐作为长期方案。

总结 #

优先用Webhook替代定时Poll，这是最彻底的解决方式；如果必须保留Poll，就用提交哈希检查的逻辑主动拦截重复构建。

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