Jenkins集成SonarQube Scanner时任务ID提取失败问题排查

问题场景 #

在Jenkins与SonarQube集成的流水线中，执行完SonarQube扫描后，尝试通过自定义函数提取任务ID时失败，报错：

ERROR: Failed to extract SonarQube Task ID from scanner output
但SonarQube后台显示扫描已成功完成，导致流水线无法进入后续的Build Docker Image和Login to GitLab Registry阶段。

相关流水线代码片段：

SonarQube任务状态检查阶段 #

// Stage to check SonarQube task status
stage('Check SonarQube Task Status') {
    steps {
        script {
            // Poll the SonarQube API for task status
            def taskId = getSonarQubeTaskId()  // Function to fetch the task ID from the previous stage
            def taskStatus = getSonarQubeTaskStatus(taskId) // Function to fetch task status

            // If the task status is not 'SUCCESS', abort the pipeline
            if (taskStatus != 'SUCCESS') {
                error "SonarQube scan failed. Aborting pipeline!"
               } else {
                echo "SonarQube scan passed. Continuing pipeline."
               }
           }
       }
}

// Function to get the SonarQube task status using the API
def getSonarQubeTaskStatus(taskId) {
    def sonarApiUrl = "${env.SONARQUBE_SERVER}/api/ce/task?id=${taskId}"
    def response = httpRequest(url: sonarApiUrl, authentication: 'sonar-token')  // Use your authentication method here
    def jsonResponse = readJSON text: response

    return jsonResponse.task.status
}

后续待执行阶段 #

stage('Build Docker Image') {
    steps {
        sh 'docker build -t $GITLAB_REGISTRY/$IMAGE_NAME:latest .'
    }
}

stage('Login to GitLab Registry') {
    steps {}
}

解决方案 #

1. 修复自定义任务ID提取函数 #

问题核心是getSonarQubeTaskId()没有正确匹配SonarScanner输出中的任务ID。先查看Jenkins控制台中SonarScanner的完整输出，找到任务ID的格式（比如Task ID: XXXXX或ceTaskId=XXXXX），然后修改提取逻辑：

def getSonarQubeTaskId() {
    // 获取最近1000行构建日志，覆盖SonarScanner输出
    def buildLogs = currentBuild.rawBuild.getLog(1000).join('\n')
    // 根据实际日志格式调整正则表达式，示例匹配"Task ID: 123ABC"格式
    def taskIdRegex = ~/Task ID: (\w+)/
    def matcher = buildLogs =~ taskIdRegex
    
    if (matcher.find()) {
        return matcher.group(1)
    } else {
        error "未在SonarScanner输出中找到任务ID，请检查日志格式"
    }
}

2. 改用SonarQube Jenkins插件内置方法（推荐） #

官方SonarQube Jenkins插件提供了内置的质量门检查方法，无需手动提取任务ID，可靠性更高：

// 先执行SonarQube扫描，使用插件环境
stage('SonarQube Scan') {
    steps {
        withSonarQubeEnv('SonarQube Server') { // 这里填你在Jenkins配置的SonarQube服务器名称
            sh 'sonar-scanner -Dsonar.projectKey=你的项目Key -Dsonar.sources=.' // 适配你的Golang项目扫描参数
        }
    }
}

// 检查质量门状态，替代自定义的任务ID检查
stage('Check SonarQube Quality Gate') {
    steps {
        script {
            def qualityGateResult = waitForQualityGate()
            if (qualityGateResult.status != 'OK') {
                error "SonarQube质量门未通过，终止流水线"
            } else {
                echo "SonarQube质量门通过，继续执行后续阶段"
            }
        }
    }
}

3. 确保Jenkins能捕获完整的SonarScanner日志 #

• 在SonarScanner执行步骤中，不要添加--quiet等限制输出的参数
• 如果Jenkins日志被截断，调整Jenkins全局配置中的“日志保留行数”，确保能包含SonarScanner的完整输出

4. 验证SonarQube API访问权限 #

确认Jenkins中配置的sonar-token凭据拥有以下SonarQube权限：

• Execute Analysis（执行分析）
• Browse（浏览项目）
  确保该token能正常访问${env.SONARQUBE_SERVER}/api/ce/task接口。

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