自托管GitLab流水线中SonarScanner报错：找不到项目默认分支

问题重现 #

在自托管GitLab流水线中执行以下SonarScanner脚本：

sonarscanner begin /k:"pkey" /n:"pname" /d:sonar.host.url="https://sonarcloud.io" /v:"1.0" /d:sonar.token="$SONAR_TOKEN" /o:"organization"
msbuild /src/mtrial.sln
sonarscanner end /d:sonar.token="$SONAR_TOKEN"

预处理阶段执行成功，但sonarscanner end时抛出错误：

ERROR: Could not find a default branch for project with key 'pkey'. Make sure project exists.

本地PowerShell运行相同脚本可成功完成分析，SonarCloud上也能正常创建项目。

解决方案 #

1. 手动指定分支参数 #

SonarScanner在GitLab环境下可能无法自动识别分支信息，在begin命令中显式指定默认分支：

sonarscanner begin /k:"pkey" /n:"pname" /d:sonar.host.url="https://sonarcloud.io" /v:"1.0" /d:sonar.token="$SONAR_TOKEN" /o:"organization" /d:sonar.branch.name="main"

替换main为你的项目实际默认分支名。

2. 检查SONAR_TOKEN的流水线权限 #

• 确认GitLab流水线中SONAR_TOKEN变量未被设置为protected；若已设置protected，需确保当前运行流水线的分支在允许访问protected变量的分支列表中。
• 验证该token在SonarCloud中拥有对应项目的分析权限（至少为"分析者"角色）。

3. 确保Git仓库状态正确 #

自托管流水线可能使用浅克隆或未检出到正确分支，在脚本开头添加Git命令修复：

git checkout main
git fetch origin main --depth=1000 # 确保获取足够的提交历史

4. 统一SonarScanner版本 #

检查流水线中使用的SonarScanner for MSBuild版本是否与本地一致，若不一致，升级到与本地相同的稳定版，避免版本兼容问题。

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