SonarQube Azure DevOps任务v4代码分析时无法定位xunit测试适配器dll

算力阿峰

2026-9-26

解决方案

根因定位

你遇到的报错和dll是否存在无关，核心是v4版本SonarQube Run Code Analysis任务的路径校验逻辑存在缺陷：所有不在代码拉取根目录F:\AzureServicesAgents\AgentU07\_work\1\s下的文件都会触发路径校验告警，而你当前的Nuget全局缓存放在系统盘的systemprofile目录下，xunit运行器属于测试依赖，本身不需要被SonarQube扫描，错误的纳入扫描范围才导致任务失败。

修复步骤

配置SonarQube扫描排除规则
在Azure DevOps Pipeline的SonarQube Prepare任务的「额外属性」配置栏添加以下参数：
```
sonar.exclusions=**/packages/**/*,**/xunit.runner.*,**/*.Test.dll
sonar.scanner.skipTestProjects=true
```
该配置会直接排除所有Nuget包目录下的依赖文件、xunit运行器相关文件和测试项目输出文件，避免非业务代码进入扫描范围。
调整Nuget全局缓存路径（可选，彻底避免跨盘符路径问题）
在运行代理的机器上新增系统环境变量NUGET_PACKAGES，值设置为F:\LocalNugetCache（和代理工作目录同盘符即可），重启代理服务后重新运行Pipeline，所有Nuget包都会拉取到同盘符目录下，不会再触发跨盘符路径校验异常。
测试项目单独配置跳过扫描（可选）
若仅部分测试项目需要排除扫描，可直接在对应测试项目的.csproj文件中添加以下配置：
```
<PropertyGroup>
  <SonarQubeExclude>true</SonarQubeExclude>
</PropertyGroup>
```
提交代码后重新运行任务即可生效。