SonarQube扫描GitHub PR报‘分支不存在’的原因排查

这个问题我之前帮团队排查过好几次，核心是SonarQube的PR分析模式和普通分支分析模式的冲突导致的，具体原因分这几点：

• PR分析模式被强制覆盖为普通分支模式
  SonarQube针对GitHub Pull Request有一套专门的PR分析逻辑，它会自动识别PR上下文来处理分支对比。但当你手动在sonar-project.properties里添加sonar.branch.name和sonar.branch.target时，会直接触发普通分支分析模式——这时候Sonar不再把当前任务当成PR分析，而是当成一个普通分支的扫描任务，它会去服务器上查找sonar.branch.target指定的develop分支，如果这个分支在Sonar服务器上不存在（比如没同步、被删除，或者服务器上的项目仓库根本没有这个分支），就会抛出“Branch does not exist on server”的错误。

• PR分析不需要手动配置分支参数
  正常做PR分析时，你完全不需要手动设置sonar.branch.name和sonar.branch.target。Sonar Scanner会通过GitHub的PR上下文（比如CI环境中传递的PR信息）自动获取源分支和目标分支的信息，前提是你正确配置了PR分析的专属参数——比如sonar.pullrequest.key（PR编号）、sonar.pullrequest.branch（源分支）、sonar.pullrequest.base（目标分支）。手动加普通分支的配置会打乱这个自动逻辑，导致Sonar找错了分支验证的方向。

• 服务器端分支的存在性验证逻辑
  在普通分支分析模式下，SonarQube会严格验证sonar.branch.target对应的分支是否存在于服务器端绑定的项目仓库中。如果你的CI环境是直接基于PR的临时分支构建，而没有提前将develop分支推送到Sonar服务器（或者服务器上的develop分支被清理了、和本地分支不同步），就会触发这个验证失败的报错。

快速修复小提示 #

如果要继续PR分析，直接删除sonar-project.properties里的sonar.branch.name和sonar.branch.target配置，换成PR专属的配置项：

# GitHub PR分析的标准配置示例
sonar.pullrequest.key=123  # 替换成你的PR编号
sonar.pullrequest.branch=feature/my-new-feature  # PR的源分支
sonar.pullrequest.base=develop  # PR的目标分支

要是你用的是GitHub Actions这类CI工具，Sonar官方的插件通常会自动帮你填充这些PR参数，连手动配置都省了。

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