Jenkins流水线节点中SonarQube质量门Pending状态及代码复用需求

刚好我之前处理过类似的多模块Maven+Jenkins+SonarQube的场景，给你拆解一下这两个问题的解决方案：

针对多文件复用扫描逻辑的需求，推荐两种Jenkins生态里的常用方案：

方法一：用Jenkins共享库实现跨流水线复用 #

这是最适合大规模复用的方案，把扫描逻辑封装成共享库函数，所有流水线都可以调用：

1. 在Git仓库里创建共享库的标准目录结构：vars/sonarMavenScan.groovy
2. 在groovy文件里编写通用扫描逻辑（可根据需求加参数）：

def call(Map config = [:]) {
    // 允许传入自定义Maven参数、Sonar属性，默认值兜底
    def mavenOpts = config.mavenOpts ?: '-Xmx2G'
    def sonarExtraProps = config.sonarProps ?: ''
    def mavenToolName = config.mavenTool ?: 'Maven-3.8.6'

    withMaven(maven: mavenToolName) {
        sh """
            mvn ${mavenOpts} org.sonarsource.scanner.maven:sonar-maven-plugin:3.9.1.2184:sonar \
                ${sonarExtraProps}
        """
    }
}

3. 在Jenkins中配置好这个共享库，之后在任意流水线里调用：

@Library('your-shared-lib-name') _

pipeline {
    agent any
    stages {
        stage('聚合扫描') {
            steps {
                sonarMavenScan(
                    sonarProps: '-Dsonar.projectKey=your-aggregate-key -Dsonar.version=1.0.0',
                    mavenOpts: '-Xmx3G'
                )
            }
        }
    }
}

方法二：单流水线内的局部函数复用 #

如果只是在当前流水线的多个阶段复用，不需要跨流水线，直接在脚本里定义局部函数即可：

// 定义局部扫描函数
def runSonarScan(String sonarProps = '') {
    withMaven(maven: 'Maven-3.8.6') {
        sh "mvn org.sonarsource.scanner.maven:sonar-maven-plugin:3.9.1.2184:sonar ${sonarProps}"
    }
}

pipeline {
    agent any
    stages {
        stage('模块A扫描') {
            steps {
                dir('module-a') {
                    runSonarScan('-Dsonar.moduleKey=module-a')
                }
            }
        }
        stage('全局聚合扫描') {
            steps {
                runSonarScan('-Dsonar.projectKey=global-aggregate')
            }
        }
    }
}

质量门Pending本质是Jenkins没收到SonarQube的扫描结果通知，或者扫描任务在Sonar端未完成，按以下步骤排查：

步骤一：配置SonarQube Webhook主动通知Jenkins #

1. 登录SonarQube后台，进入你的项目 → 项目设置 → Webhooks
2. 添加Webhook，URL填http://<你的Jenkins地址>/sonarqube-webhook/（注意结尾的斜杠必须加）
3. 点击「测试」，确认Jenkins返回200 OK的响应，确保网络连通性没问题

步骤二：在流水线中显式轮询质量门结果 #

如果Webhook不稳定，可以用Jenkins Sonar插件的waitForQualityGate()方法主动轮询，替代被动等待：

stage('Sonar扫描&质量门检查') {
    steps {
        // 绑定SonarQube环境变量（提前在Jenkins配置好Sonar服务器）
        withSonarQubeEnv('your-sonar-server-name') {
            runSonarScan('-Dsonar.projectKey=your-project')
        }
    }
    post {
        always {
            script {
                def qualityGate = waitForQualityGate()
                if (qualityGate.status != 'OK') {
                    error "Sonar质量门未通过：${qualityGate.status}"
                }
            }
        }
    }
}

注意：确保Jenkins的SonarQube插件版本≥2.13，这个版本才支持waitForQualityGate()

步骤三：检查扫描权限和参数 #

• 确认Maven扫描命令中，sonar.login使用的Token拥有SonarQube项目的「浏览」权限
• 检查SonarQube后台的「项目分析历史」，确认扫描任务已经成功完成（没有失败或卡住）
• 确保Jenkins节点能访问SonarQube的API：在Jenkins节点上执行curl http://<sonar地址>/api/system/status，验证返回正常

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