Jenkins Pipeline无法触发指定前缀分支代码变更构建求助

问题核心原因 #

1. 分支变量大小写不匹配：你在environment里定义的是branch（小写），但git步骤里误用了$env.Branch（大写），导致分支过滤规则失效。
2. PollSCM无法获取SCM仓库基线：git步骤放在stage的steps中，而Jenkins的PollSCM操作是在流水线运行之外执行的，不会走到stage里的代码拉取步骤，因此无法识别要监控的仓库，也就无法建立polling基线（对应日志里的no polling baseline）。
3. 重复定义触发器：同时在triggers块和stage内的properties中定义PollSCM，可能导致配置冲突。

修正方案 #

方案一：顶层定义SCM配置（推荐）

将SCM仓库配置放在Pipeline顶层，让PollSCM在初始化阶段就能识别要监控的仓库和分支规则：

@Library("MySharedLibrary") _

pipeline {
    agent any
    
    // 顶层配置SCM，供PollSCM和代码拉取复用
    scm {
        git(
            branch: ".*/(?i)MyBranchPrefix[^/]*",
            credentialsId: 'MyGitCredentials',
            url: 'https://mygitserver.local/myrepository.git'
        )
    }
    
    triggers {
        // 配置轮询频率，示例为每分钟轮询一次
        pollSCM '* * * * *'
    }
    
    options {
        lock resource: 'MyLock'
        skipDefaultCheckout() // 跳过默认拉取，后续手动清理后拉取
    }

    stages {
        stage('Pull source') {
            steps {
                cleanWs()
                checkout scm // 复用顶层SCM配置拉取代码
                
                script {
                    echo 'Pulled source code'
                }                
            }
        }
    }
}

方案二：通过Properties动态配置SCM触发器

适合需要动态调整触发器规则的场景，在脚本最外层定义properties确保PollSCM能获取到完整的SCM信息：

@Library("MySharedLibrary") _

// 外层配置触发器，确保PollSCM能识别监控的仓库
properties([
    pipelineTriggers([
        $class: 'SCMTrigger',
        scm: [
            $class: 'GitSCM',
            branches: [[name: ".*/(?i)MyBranchPrefix[^/]*"]],
            userRemoteConfigs: [[
                credentialsId: 'MyGitCredentials',
                url: 'https://mygitserver.local/myrepository.git'
            ]]
        ],
        spec: '* * * * *' // 轮询频率
    ])
])

pipeline {
    agent any
    
    options {
        lock resource: 'MyLock'
    }

    stages {
        stage('Pull source') {
            steps {
                cleanWs()
                
                git(
                    branch: ".*/(?i)MyBranchPrefix[^/]*",
                    changelog: true,
                    credentialsId: 'MyGitCredentials',
                    poll: true,
                    url: 'https://mygitserver.local/myrepository.git'
                )
                
                script {
                    echo 'Pulled source code'
                }                
            }
        }
    }
}

关键注意事项 #

• 手动触发一次构建：配置完成后必须手动跑一次构建，让Jenkins建立初始的polling基线，否则PollSCM依然会显示没有基线。
• 确认共享库配置：保持Include @Library changes in job recent changes选项未勾选，避免共享库仓库的变更触发构建。
• 调整轮询频率：* * * * *是每分钟轮询，可根据需求修改（比如H/15 * * * *表示每15分钟轮询一次，H用于避免所有任务同时触发）。
• 分支规则验证：确认.*/(?i)MyBranchPrefix[^/]*规则符合你的分支命名，该规则会不区分大小写匹配所有前缀为MyBranchPrefix的分支。

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