SonarQube MSBuild Scanner配置问题：测试报告路径错误与重复解析

针对你在Jenkins Pipeline中配置MSBuild Scanner + dotCover遇到的问题，我来逐一拆解解决方案：

核心问题1：通用测试报告路径解析失败（"Test execution data ignored for unknown files"） #

这个问题的本质是SonarQube识别的项目文件路径，和你转换后的通用测试XML里记录的路径不匹配。哪怕是大小写、路径分隔符、相对基准目录的细微差异，都会导致Sonar无法关联测试数据。

具体修复步骤： #

1. 对齐路径基准目录
   你的Jenkins当前工作目录是Source的上级目录（因为你执行dotnet test Source/my.Sln），而Sonar扫描的基准目录也是这个上级目录。所以转换后的通用测试XML里的文件路径，必须是相对于这个上级目录的格式，比如Source/Proj1/Class1.cs，而不是Proj1/Class1.cs（相对Source目录）或者绝对路径。

   • 检查你的XSLT转换逻辑：TRX文件里的测试文件路径可能是绝对路径，或者相对于测试项目的路径，你需要在XSLT里把它调整为相对于Jenkins工作目录的相对路径。比如如果TRX里的路径是D:/Jenkins/workspace/Job/Source/Proj1/Class1.cs，就截取掉前缀，保留Source/Proj1/Class1.cs；如果是相对路径../../Proj1/Class1.cs，就转换为Source/Proj1/Class1.cs。

2. 统一路径分隔符
   Windows生成的TRX文件会用反斜杠\，但SonarQube更倾向于正斜杠/作为路径分隔符。在XSLT里添加一个替换逻辑，把所有\替换成/。

3. 验证路径匹配度

   • 手动打开转换后的通用测试XML，查看<file>标签的path属性值。
   • 登录SonarQube，进入你的项目，查看任意一个被标记为"unknown"的文件的完整路径（比如在代码页面点击文件，查看浏览器地址栏里的路径），对比两者是否完全一致（包括大小写！有些环境下Sonar对大小写敏感）。

4. 调整sonar.testExecutionReportPaths参数
   确保你指定的报告路径是相对于Jenkins工作目录的相对路径，比如转换后的文件在Source/TestResults/ConvertedTestReport.xml，就直接写这个路径，不要用绝对路径或者相对Source目录的路径。

次要问题2：SonarQube重复解析测试报告 #

因为你针对整个解决方案执行dotnet test，每个测试项目都会生成独立的TRX文件，转换后也会有多个通用测试XML。SonarQube会逐一解析所有指定的报告，如果不同测试报告里包含相同的被测试文件，就会出现重复解析的情况。

优化建议： #

• 在转换完成后，把所有通用测试XML合并成一个文件，然后只在sonar.testExecutionReportPaths里指定这个合并后的文件。这样既能减少Sonar的解析次数，也能避免重复统计。

调试技巧 #

开启Sonar的 verbose日志，在begin命令里添加参数：

SonarQube.Scanner.MSBuild.exe begin /d:sonar.testExecutionReportPaths=convertedXmlCommaDelimitedList /d:sonar.verbose=true

日志里会详细输出Sonar解析测试报告时的路径匹配过程，能帮你快速定位哪条路径不匹配。

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