Github Actions中Fork仓库PR的Sonar扫描无法识别覆盖率报告

核心问题根源 #

workflow_run触发的任务与原PR任务处于独立执行环境，覆盖率报告的路径匹配、Sonar配置的明确性、PR上下文的传递这三点是导致覆盖率信息不显示的关键。

具体解决方案 #

• 严格对齐覆盖率报告的上传与下载路径
  原PR任务上传工件时，明确指定包含所有覆盖率相关文件的目录，确保路径完整：

  - name: 上传覆盖率工件
    uses: actions/upload-artifact@v4
    with:
      name: coverage-reports
      path: |
        build/jacoco/jacoco.exec
        build/reports/jacoco/test/jacocoTestReport.xml
      retention-days: 7
  

  在workflow_run任务中，下载时直接将工件放到与原任务完全一致的路径下，避免路径错位：

  - name: 下载覆盖率工件
    uses: actions/download-artifact@v4
    with:
      name: coverage-reports
      path: build/
  

• 强制SonarQube指定覆盖率报告路径
  Sonar默认路径可能与项目结构不匹配，必须手动明确所有覆盖率相关参数，以Jacoco为例：

  - name: Sonar分析
    uses: SonarSource/sonarcloud-github-action@master
    env:
      GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
      SONAR_TOKEN: ${{ secrets.SONAR_TOKEN }}
    with:
      args: >
        -Dsonar.java.coveragePlugin=jacoco
        -Dsonar.jacoco.reportPaths=build/jacoco/jacoco.exec
        -Dsonar.coverage.jacoco.xmlReportPaths=build/reports/jacoco/test/jacocoTestReport.xml
  

  注意：路径必须与下载后的文件实际路径完全一致，Sonar会跳过不存在的路径对应的报告。

• 验证文件存在性
  在Sonar分析前添加步骤，确认覆盖率文件已正确下载到指定位置，快速排查路径问题：

  - name: 检查覆盖率文件
    run: |
      ls -la build/jacoco/
      ls -la build/reports/jacoco/test/
  

• 传递PR上下文给Sonar
  workflow_run任务默认不携带原PR的上下文，需要手动提取并传递给Sonar，确保分析结果关联到对应PR：

  - name: 获取原PR编号
    id: get-pr
    run: |
      PR_NUMBER=$(jq -r '.pull_request.number' "$GITHUB_EVENT_PATH")
      echo "pr_number=$PR_NUMBER" >> "$GITHUB_OUTPUT"
  - name: Sonar分析
    uses: SonarSource/sonarcloud-github-action@master
    env:
      GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
      SONAR_TOKEN: ${{ secrets.SONAR_TOKEN }}
    with:
      args: >
        -Dsonar.pullrequest.key=${{ steps.get-pr.outputs.pr_number }}
        -Dsonar.pullrequest.base=main
        -Dsonar.pullrequest.branch=refs/pull/${{ steps.get-pr.outputs.pr_number }}/head
        -Dsonar.java.coveragePlugin=jacoco
        -Dsonar.jacoco.reportPaths=build/jacoco/jacoco.exec
        -Dsonar.coverage.jacoco.xmlReportPaths=build/reports/jacoco/test/jacocoTestReport.xml
  

• 禁止重复执行测试
  若原PR任务已生成覆盖率报告，workflow_run中不要再次执行单元测试，避免覆盖已有的有效覆盖率文件。

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