如何禁用SonarQube自动分支检测或修正默认分支识别？

针对你遇到的SonarQube分支检测与默认分支识别问题，这里分场景给出具体处理方式：

1. 不设置sonar.branch.name跳过自动分支检测 #

可以通过添加sonar.scanner.skipBranchDetection=true属性强制关闭自动分支检测逻辑，这样扫描任务不会自动设置sonar.branch.name，SonarQube会将本次扫描识别为主分支分析。

在Gradle的SonarQube任务中配置该属性即可：

sonarqube {
    properties {
        property "sonar.scanner.skipBranchDetection", "true"
    }
}

2. 让分支检测逻辑正确识别默认分支 #

有两种可行方式：

• SonarQube项目端配置主分支：直接在SonarQube对应项目的设置中，将develop设置为项目的主分支。这样即使扫描器自动设置了sonar.branch.name=develop，SonarQube也会将其识别为主分支分析。
• GitHub Actions中动态判断分支：通过Actions环境变量判断当前分支是否为默认分支，仅在非默认分支时设置sonar.branch.name，默认分支时关闭自动检测。示例逻辑如下（结合Gradle配置）：
  在GitHub Actions工作流中先获取默认分支名，再传递给Gradle：

  - name: Run SonarQube Scan
    env:
      DEFAULT_BRANCH: ${{ github.event.repository.default_branch }}
      CURRENT_BRANCH: ${{ github.ref_name }}
    run: ./gradlew sonarqube -Dsonar.scanner.skipBranchDetection=${{ env.CURRENT_BRANCH == env.DEFAULT_BRANCH }}
  

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