SonarQube扫描报错：分支分析不能携带sonar.pullrequest.key参数

架构老林

2026-9-25

问题原因

核心触发原因是sonar.pullrequest.key参数为空：${{ github.event.number }}变量仅在GitHub Actions工作流由pull_request系列事件触发时才会返回合法的PR编号，若工作流由push、tag推送、手动触发等非PR事件触发时，该变量值为空。
SonarQube的参数校验逻辑：当检测到你传入了sonar.pullrequest.key参数但值为空时，会自动切换为分支分析模式，但分支分析模式不允许携带任何PR分析相关参数，因此抛出对应报错。

修复方案

1. 限制工作流/步骤的触发范围

在你的GitHub Actions配置中，要么给整个工作流添加仅PR触发的规则，要么给SonarQube扫描步骤添加执行条件，确保仅PR事件触发时才执行该步骤：

# 给整个工作流加触发规则示例
on:
  pull_request:
    types: [opened, synchronize, reopened]

# 或者给单步骤加执行条件示例
- name: Run sonarqube
  if: github.event_name == 'pull_request'
  run: # 你的sonar-scanner命令

2. 优化参数传递逻辑，兼容非PR场景

如果你需要在非PR场景也执行SonarQube扫描，可以将PR参数改为变量判断，仅当存在PR编号时才传入相关参数，示例如下：

- name: Run sonarqube
  run: |
    if [ -n "${{ github.event.number }}" ]; then
      sonar-scanner \
        -Dsonar.scm.provider=git \
        -Dsonar.login=${{ secrets.SONARQUBE_TOKEN }} \
        -Dsonar.pullrequest.key=${{ github.event.number }} \
        -Dsonar.pullrequest.branch=${GITHUB_HEAD_REF#refs/heads/} \
        -Dsonar.pullrequest.base=${GITHUB_BASE_REF#refs/heads/} \
        -Dsonar.pullrequest.github.repository=${GITHUB_REPOSITORY} \
        -Dsonar.pullrequest.github.endpoint=${GITHUB_API_URL}
    else
      sonar-scanner \
        -Dsonar.scm.provider=git \
        -Dsonar.login=${{ secrets.SONARQUBE_TOKEN }} \
        -Dsonar.branch.name=${GITHUB_REF#refs/heads/}
    fi