SonarQube 6.7.6分支分析：build.dependsOn sonar无效，如何让PR构建失败？

首先，你遇到的问题很典型：单纯用build.dependsOn sonar无法达到预期效果，因为默认情况下sonar任务只会完成分析结果的上传，不会同步检查SonarQube的质量门状态——哪怕质量门未通过，这个任务也会返回"成功"，所以依赖它的build任务自然不会失败。

下面给你两个适配SonarQube 6.7.6版本的解决方案：

方案1：利用SonarQube插件内置的质量门等待功能 #

SonarQube Gradle插件（对应6.7.6版本的插件一般是2.x系列）支持通过配置参数让sonar（或sonarqube）任务等待质量门结果，并在未通过时抛出异常终止构建。

步骤如下：

1. 在build.gradle中添加Sonar质量门等待配置：

// 如果你的插件用的是旧名称"sonar"，就用sonar块；如果是新的"sonarqube"，就替换成sonarqube块
sonar {
    properties {
        // 开启质量门等待，任务会轮询直到Sonar完成分析并返回质量门状态
        property "sonar.qualitygate.wait", "true"
    }
}

2. 保持build任务对Sonar任务的依赖：

// 注意任务名称要和上面的块对应，是sonar还是sonarqube
build.dependsOn sonar

这样配置后，当Sonar分析完成且质量门未通过时，sonar任务会直接失败，进而导致依赖它的build任务终止，PR构建自然就失败了。

方案2：自定义任务检查质量门状态（备用方案） #

如果方案1因为插件版本或服务器配置问题不生效，可以自定义Gradle任务，通过SonarQube的API主动查询质量门状态，强制终止构建。

示例代码如下：

task enforceSonarQualityGate {
    // 确保在sonar任务完成后再执行
    dependsOn sonar
    doLast {
        // 替换成你的SonarQube服务器地址、项目Key
        def sonarServer = "http://your-sonar-server:9000"
        def projectKey = "your-project-key"
        // 获取当前分支名称（根据你的CI环境调整，比如Jenkins用BRANCH_NAME，GitHub Actions用GITHUB_REF_NAME）
        def branchName = System.getenv("BRANCH_NAME") ?: "develop"

        // 1. 获取最新的分析任务ID
        def componentTaskUrl = "${sonarServer}/api/ce/component?component=${projectKey}&branch=${branchName}"
        def taskResponse = new URL(componentTaskUrl).text
        def taskId = new groovy.json.JsonSlurper().parseText(taskResponse).task.id

        // 2. 轮询等待分析任务完成
        def taskStatus
        do {
            sleep(5000) // 每5秒查询一次
            def taskInfoUrl = "${sonarServer}/api/ce/task?id=${taskId}"
            def taskInfo = new URL(taskInfoUrl).text
            taskStatus = new groovy.json.JsonSlurper().parseText(taskInfo).task.status
        } while (taskStatus in ["IN_PROGRESS", "PENDING"])

        // 3. 检查质量门状态
        def qualityGateUrl = "${sonarServer}/api/qualitygates/project_status?projectKey=${projectKey}&branch=${branchName}"
        def gateResponse = new URL(qualityGateUrl).text
        def gateStatus = new groovy.json.JsonSlurper().parseText(gateResponse).projectStatus.status

        // 如果质量门未通过，抛出异常终止构建
        if (gateStatus != "OK") {
            throw new GradleException("SonarQube质量门未通过，PR构建终止！")
        }
    }
}

// 让build任务依赖这个自定义检查任务
build.dependsOn enforceSonarQualityGate

注意事项 #

• SonarQube 6.7.6的分支分析功能需要商业版授权（Community Edition不支持分支分析），如果你用的是社区版，这个方案可能无法生效。
• 自定义任务需要你的CI环境有访问SonarQube API的权限，并且项目Key、分支名称要正确匹配。
• 6.7.6是已经停止维护的旧版本，建议尽可能升级到受支持的新版本，能获得更稳定的分支分析和质量门集成能力。

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