Jenkins多分支流水线中如何拉取PR目标分支以支持SonarQube分析？

方法1：在流水线中显式拉取目标分支 #

在Sonar扫描前添加Git命令，主动拉取目标分支（示例为main）：

pipeline {
    agent any
    environment {
        SONAR_TOKEN = credentials('sonar-token')
    }
    stages {
        stage('Checkout') {
            steps {
                checkout scm
                // 显式拉取目标分支到本地远程分支引用
                sh 'git fetch origin main:refs/remotes/origin/main'
            }
        }
        stage('Build') {
            steps {
                echo 'Building..'
            }
        }
        stage('Test') {
            steps {
                sh '''
                    printenv
                    ./gradlew sonar -Dsonar.pullrequest.key=4 -Dsonar.pullrequest.branch=feature/add-jenkins -Dsonar.pullrequest.base=main
                '''
            }
        }
        stage('Deploy') {
            steps {
                echo 'Deploying....'
            }
        }
    }
}

该操作会将目标分支拉取到本地，满足SonarQube PR分析的对比需求。

方法2：配置多分支流水线的分支源Refspec #

在Jenkins多分支流水线的分支源配置（以GitHub/GitLab为例）中：

• 找到「Refspec」输入框，添加包含目标分支的拉取规则：

  +refs/heads/*:refs/remotes/origin/*, +refs/pull/*/head:refs/remotes/origin/pr/*
  

  此配置会拉取所有远程分支（含PR目标分支），同时保留PR分支的拉取逻辑。
• 保存配置后重新触发流水线，Jenkins会自动拉取所需分支。

方法3：使用checkout指令的扩展参数 #

通过checkout指令的扩展选项，自定义Git拉取参数，精准指定要拉取的目标分支：

stage('Checkout') {
    steps {
        checkout([
            $class: 'GitSCM',
            branches: [[name: '*/feature/add-jenkins']],
            extensions: [
                [$class: 'CloneOption', noTags: false, shallow: false],
                // 指定拉取main分支的refspec
                [$class: 'FetchOption', refspec: '+refs/heads/main:refs/remotes/origin/main']
            ],
            userRemoteConfigs: [[url: 'https://github.com/my-user/sonar-test.git']]
        ])
    }
}

这种方式可避免拉取所有分支带来的冗余，仅获取分析所需的目标分支。

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