SonarCloud无法分析PR，主分支已完成分析该如何解决？

我之前也碰到过一模一样的问题——本地主分支分析完SonarCloud有数据，但GitHub Actions里的PR扫描就是报Project was never analyzed. A regular analysis is required before analyzing a pull request。下面是我亲测有效的几个排查和解决步骤，你可以逐一尝试：

1. 确保主分支的分析是通过GitHub Actions完成的 #

本地提交的分析数据有时候不会被SonarCloud视为CI环境的基线，它需要通过GitHub Actions流水线完成至少一次主分支的完整分析才能认可PR分析的基准。你可以：

• 手动触发一次主分支的GitHub Actions workflow，重点确认SonarCloud的扫描上传步骤没有报错（看Workflow日志里的SonarCloud输出）
• 去SonarCloud项目页面的分支管理栏，检查主分支的最新分析记录，确认它的来源是GitHub Actions，而不是本地提交

2. 检查PR分析的SonarCloud配置参数 #

PR分析的步骤必须正确关联主分支作为基线，确保你的GitHub Actions workflow里的SonarCloud步骤配置了这些关键参数：

• sonar.pullrequest.base: 明确设置为主分支名称（比如master或main，根据你的实际分支名调整）
• sonar.branch.target: 同样指定主分支
• 保证PR分析的项目Key、组织名、token等配置和主分支分析的完全一致

举个配置示例，你的workflow里的SonarCloud步骤应该类似这样：

- name: SonarCloud PR Scan
  uses: SonarSource/sonarcloud-github-action@master
  env:
    GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
    SONAR_TOKEN: ${{ secrets.SONAR_TOKEN }}
  with:
    args: >
      -Dsonar.projectKey=你的项目Key
      -Dsonar.organization=你的组织名
      -Dsonar.pullrequest.key=${{ github.event.number }}
      -Dsonar.pullrequest.base=master
      -Dsonar.pullrequest.branch=${{ github.head_ref }}

3. 清理SonarCloud的旧分支数据和缓存 #

有时候SonarCloud的缓存或无效分支记录会干扰基线识别：

• 登录SonarCloud，进入项目的Administration > Branches页面，删除无关的旧分支记录
• 重新触发一次主分支的完整分析，再触发PR的分析任务

4. 检查GitHub Actions的权限设置 #

确保GitHub Actions的GITHUB_TOKEN有足够权限访问SonarCloud并读取PR信息：

• 进入仓库的Settings > Actions > General，确认Workflow permissions设置为Read and write permissions
• 检查SonarCloud中项目的GitHub绑定设置，确保仓库和SonarCloud项目的关联是正确的

如果以上步骤都试过还是不行，建议去SonarCloud的PR分析详情页查看完整日志，里面会有更具体的错误提示，方便进一步定位问题。

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