SonarCloud Maven扫描报错：无法找到默认分支，求解决方案

核心原因 #

你遇到的扫描报错+SonarCloud分支接口404问题，本质是旧版Maven扫描器与SonarCloud的API兼容性冲突，和你本地的SonarQube 8.x版本完全无关——因为你对接的是SonarCloud远程服务，本地SonarQube只是独立的本地开发工具，两者互不影响。

SonarCloud在2022年更新了分支管理API，你使用的sonar-maven-plugin:3.9.1.2184是2021年发布的旧版本，它调用的分支API已被SonarCloud废弃，导致接口返回404，进而触发默认分支 fallback 失败。

解决方案 #

1. 升级Maven扫描器版本
   直接将插件版本升级到4.0.0.2504及以上，推荐使用最新稳定版（当前为4.2.0.3129），修改pom.xml中的插件配置：

   <plugin>
       <groupId>org.sonarsource.scanner.maven</groupId>
       <artifactId>sonar-maven-plugin</artifactId>
       <version>4.2.0.3129</version>
   </plugin>
   

   新版插件适配了SonarCloud的新分支API，会自动处理默认分支逻辑，无需额外配置。

2. 验证SonarCloud项目分支设置（可选）
   如果升级后仍有问题，进入SonarCloud项目后台确认：

   • 项目主页 → Administration → Branches and Pull Requests
   • 确保Main Branch下拉框中选择了正确的默认分支（比如main或master）

误区澄清 #

不要尝试升级本地SonarQube来解决问题，这和SonarCloud的扫描兼容性没有任何关系，两者是完全独立的服务，问题只存在于扫描器与SonarCloud之间。

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