Azure DevOps管道中SonarCloud无法导入Coverlet代码覆盖率的问题

问题背景 #

在Azure DevOps中部署了针对.NET解决方案的SonarCloud分析管道，管道可正常构建并向Azure DevOps发布代码覆盖率，但存在以下异常：

• 日志显示SonarCloud持续启用JaCoCo传感器检测覆盖率，而非适配.NET项目的OpenCover传感器
• 手动创建的sonar-project.properties配置文件未被读取
• SonarCloud尝试用OpenCover解析报告时，报错缺少<CoverageSession>根元素

管道核心配置片段：

- task: DotNetCoreCLI@2
  displayName: Run tests and collect coverage
  inputs:
    command: test
    arguments: '--configuration $(buildConfiguration) --collect:"XPlat Code Coverage"'
    projects: '**/*.Test.csproj'
    publishTestResults: true

# 覆盖率报告生成脚本
- script: |
    dotnet tool install -g dotnet-reportgenerator-globaltool
    reportgenerator -reports:$(Agent.WorkFolder)/**/coverage.cobertura.xml -targetdir:$(Build.SourcesDirectory)/CoverageResults -reporttypes:'HtmlInline_AzurePipelines;Cobertura'
  displayName: Create code coverage report

使用的sonar-project.properties内容：

sonar.cs.opencover.reportsPaths=**/CoverageResults/Cobertura.xml
sonar.coverageReportPaths=**/CoverageResults/Cobertura.xml

核心问题分析 #

1. 格式不匹配：SonarCloud的C#分析器仅支持OpenCover格式的覆盖率报告，而你用ReportGenerator生成的是Cobertura格式——两者根元素完全不同（OpenCover为<CoverageSession>，Cobertura为<coverage>），直接导致解析报错。
2. 配置触发错误传感器：sonar.coverageReportPaths是通用覆盖率配置项，会触发JaCoCo传感器尝试读取报告，覆盖了针对C#的OpenCover专属配置。
3. 配置文件加载问题：若sonar-project.properties未放在仓库根目录，SonarCloudPrepare任务可能无法正确加载该文件。

解决步骤 #

1. 修正ReportGenerator输出格式 #

修改覆盖率报告生成脚本，将输出格式改为OpenCover（保留HTML报告用于Azure DevOps展示）：

dotnet tool install -g dotnet-reportgenerator-globaltool
reportgenerator -reports:$(Agent.WorkFolder)/**/coverage.cobertura.xml -targetdir:$(Build.SourcesDirectory)/CoverageResults -reporttypes:'HtmlInline_AzurePipelines;OpenCover'

2. 修正SonarCloud覆盖率配置 #

方案A：使用任务内配置（推荐，避免文件读取问题）

在SonarCloudPrepare@1任务中添加extraProperties，直接指定OpenCover报告路径：

- task: SonarCloudPrepare@1
  displayName: 'Prepare SonarCloud analysis configuration'
  inputs:
    # 保留原有必填配置（如organization、projectKey等）
    extraProperties: |
      sonar.cs.opencover.reportsPaths=$(Build.SourcesDirectory)/CoverageResults/OpenCover.xml

方案B：修正sonar-project.properties文件

确保文件放在仓库根目录，仅保留C#专属配置：

sonar.cs.opencover.reportsPaths=**/CoverageResults/OpenCover.xml

注意：必须删除sonar.coverageReportPaths配置，避免触发JaCoCo传感器。

3. 验证管道执行 #

重新运行管道后，检查日志确认：

• SonarCloud加载C# OpenCover Coverage Report Import传感器，而非JaCoCo
• 不再出现<CoverageSession>根元素缺失的错误
• SonarCloud平台能正常展示.NET项目的覆盖率数据

关键说明 #

• dotnet test --collect:"XPlat Code Coverage"的配置没有问题，它生成的Cobertura格式是ReportGenerator的合法输入，只需转换为SonarCloud支持的OpenCover格式即可。
• 优先使用SonarCloudPrepare任务的extraProperties配置，比外部sonar-project.properties更可靠，能避免路径解析和文件加载问题。

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