Jenkins集成SonarQube时waitForQualityGate用错ID返回404如何解决

• 排查运行环境一致性

  waitForQualityGate步骤默认读取当前工作空间下.sonar/report-task.txt文件存储的ceTaskId作为查询参数，若Sonar扫描阶段和质量门禁阶段运行在不同Jenkins节点、不同工作空间，或中间执行过工作空间清理操作，会导致插件读取不到正确的任务ID，甚至读取到历史任务的旧ID。
  可在Sonar扫描阶段通过stash功能暂存report-task.txt文件，质量门禁阶段先unstash再执行检查。

• 显式传入任务ID避免自动读取错误
  直接修改流水线配置，主动捕获扫描生成的任务ID并传入waitForQualityGate步骤，从根源避免ID匹配错误，修改后的参考配置如下：

stage('Sonar') {
    steps {
        // 提前清理旧的扫描文件，避免干扰
        sh 'rm -rf .sonar'
        withSonarQubeEnv(installationName: 'Sonarqube', credentialsId: 'sonar') {
            sh "$SCANNER_HOME/bin/sonar-scanner -D'sonar.projectKey=$JOB_NAME'"
        }
        script {
            // 读取本次扫描生成的任务ID
            def reportTaskProps = readProperties file: '.sonar/report-task.txt'
            env.SONAR_CE_TASK_ID = reportTaskProps.ceTaskId
        }
    }
    post {
        always {
            // 暂存任务ID文件，跨节点也可正常读取
            stash name: 'sonar-task-info', includes: '.sonar/report-task.txt'
        }
    }
}
stage("Quality Gate") {
    steps {
        unstash 'sonar-task-info'
        timeout(time: 1, unit: 'HOURS') {
            // 显式指定任务ID，避免插件读取错误
            waitForQualityGate abortPipeline: true, sonarTaskId: env.SONAR_CE_TASK_ID
        }
    }
}

• 检查版本兼容性
  版本低于2.13的SonarQube Scanner for Jenkins插件存在任务ID匹配的已知bug，可将插件升级至最新稳定版，同时确认SonarQube服务端版本与插件版本适配。
• 清理历史残留文件
  若同一工作空间执行过多次扫描任务，旧的.sonar目录文件可能导致ID读取错误，在扫描前执行rm -rf .sonar清理即可。

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