SonarQube社区版：如何基于特性分支分析阻止合并到主分支？

完全可行，不需要SonarQube付费版的高级功能，通过GitLab CI流水线状态+分支保护规则就能实现需求，具体步骤如下：

1. 配置特性分支CI流水线的SonarQube分析任务 #

在特性分支专用的.gitlab-ci-br.yml中添加SonarQube分析阶段，让流水线能根据代码质量结果判断是否失败：

stages:
  - build
  - test
  - sonarqube-check

# 这里省略你的build、test等已有任务
sonarqube-check:
  stage: sonarqube-check
  image: sonarsource/sonar-scanner-cli:latest
  variables:
    SONAR_USER_HOME: "${CI_PROJECT_DIR}/.sonar"
    # 确保拉取完整提交历史，SonarQube能准确对比分支差异
    GIT_DEPTH: "0"
  script:
    # 执行SonarQube分析
    - sonar-scanner -Dsonar.projectKey=你的项目标识 -Dsonar.sources=. -Dsonar.host.url=你的SonarQube地址 -Dsonar.login=你的SonarQube令牌
    # 可选：通过SonarQube API判断质量门状态，社区版支持此API
    - |
      # 提取分析ID
      ANALYSIS_ID=$(grep "Analysis ID" sonar-scanner.log | awk '{print $3}')
      # 调用API获取质量门状态
      QUALITY_GATE_STATUS=$(curl -u ${SONAR_LOGIN}: -s "${SONAR_HOST_URL}/api/qualitygates/project_status?analysisId=${ANALYSIS_ID}" | jq -r '.projectStatus.status')
      # 质量门非OK则让任务失败
      if [ "$QUALITY_GATE_STATUS" != "OK" ]; then
        echo "SonarQube质量门未通过，阻止合并"
        exit 1
      fi
  cache:
    key: "${CI_JOB_NAME}"
    paths:
      - .sonar/cache
  only:
    # 仅在合并请求触发时运行
    - merge_requests

注：社区版支持自定义质量门（比如设置新增BUG数>0、新增漏洞数>0则质量门失败），先在SonarQube后台配置好对应规则。

2. 配置GitLab分支保护规则 #

进入GitLab项目的「设置」→「仓库」→「分支保护规则」，找到main分支的保护规则：

• 勾选需要通过所有流水线：只要特性分支的CI流水线（包括SonarQube分析任务）失败，就无法发起合并。
• 可选：搭配「需要代码所有者审批」等规则，进一步强化代码质量管控。

3. 关键注意事项 #

• 确保GitLab Runner能访问你的SonarQube服务器，SonarQube令牌拥有项目分析、质量门状态读取的权限。
• 在SonarQube后台开启对合并请求的分析支持（社区版默认支持），确保能准确对比特性分支与main分支的代码差异。
• 确认.gitlab-ci-br.yml的only规则正确，只在合并请求事件触发时运行SonarQube分析任务。

内容的提问来源于stack exchange，提问作者Zakaria Ait Yakoub