TeamCity DotCover报告集成SonarQube无覆盖率数据求助

看了你的配置和日志，明明显示已经解析了dotCover的HTML报告，甚至统计出34个有覆盖的主文件，但SonarQube里就是看不到数据——这种情况我之前也踩过坑，给你几个针对性的排查和解决方向：

1. 优先让Sonar直接解析DotCover的原始快照文件（而非HTML） #

你现在是把dcvr合并后转成HTML再让Sonar解析，但SonarQube的C#插件其实原生支持读取dotCover的.dcvr文件，HTML转译反而可能引入路径匹配的问题。

操作步骤：
在「Sonar Scanner for MsBuild：开始分析」步骤里，添加额外的命令行参数：

/d:sonar.cs.dotcover.reportsPaths="%system.teamcity.build.checkoutDir%\dotcovermerge.dcvr"

同时可以去掉原来指向HTML报告的配置，让Sonar直接读取合并后的原始快照，路径匹配的准确性会高很多。

2. 检查文件路径的一致性问题 #

日志里显示解析了报告，但SonarQube无法关联到代码文件，大概率是dotCover报告里的文件路径和Sonar扫描时的文件路径不匹配（比如绝对路径差异、大小写问题，或者TeamCity工作目录别名导致的路径差异）。

验证与解决：

• 打开你生成的dotCover.html报告，随便找一个有覆盖的文件，看它的完整路径（比如D:\TeamCityBuildAgent\work\4ebc0abc7b8ceda0\src\MyProject\File.cs）
• 对比SonarQube项目里对应文件的路径（在SonarQube「代码」页面查看文件完整路径）
• 如果路径不一致，给dotCover.exe report命令添加相对路径参数：

  %teamcity.dotCover.home%\dotCover.exe report /ReportType=HTML /Source=%system.teamcity.build.checkoutDir%\dotcovermerge.dcvr /Output="%system.teamcity.build.checkoutDir%\dotCover.html" /UseRelativePaths=true
  

3. 检查SonarQube项目的分析范围配置 #

有可能SonarQube把你有覆盖的文件排除在了分析范围外，导致即使覆盖率数据被解析了，也不会显示在项目里。

检查步骤：

1. 登录SonarQube进入你的项目
2. 点击「Administration」→「General Settings」→「Analysis Scope」
3. 查看「Exclusions」和「Inclusions」配置，确保有覆盖的主文件没有被排除
4. 确认「Test Files」配置是否正确，不要把主文件误标记为测试文件

4. 验证DotCover快照的有效性 #

虽然日志里显示合并了快照，但有可能合并后的.dcvr文件是空的或者不完整，导致Sonar解析不到有效数据。

验证方法：

• 直接用JetBrains dotCover打开dotcovermerge.dcvr文件，看是否能正常显示覆盖率数据
• 如果打开后看不到覆盖信息，检查TeamCity测试步骤：
  • 确认「代码覆盖率工具」选择的是「JetBrains dotCover」
  • 查看测试步骤日志，有没有「dotCover coverage session started」和「Coverage session finished successfully」的记录
  • 检查测试命令是否正确指定了要测试的程序集

5. 确认Sonar Scanner for MsBuild的版本兼容性 #

SonarQube 8.5需要搭配Sonar Scanner for MsBuild 4.8及以上版本使用，如果你的Scanner版本太低，可能对新版本的dotCover支持有问题。

检查方法：

• 在TeamCity的「Sonar Scanner for MsBuild」步骤里查看使用的Scanner版本
• 如果版本低于4.8，建议升级到兼容版本（SonarQube 8.5对应的最新兼容Scanner版本为4.10左右）

按上面的步骤逐一排查，应该能解决覆盖率不显示的问题。

内容的提问来源于stack exchange，提问作者Harald S. Hanssen