本地测试正常但Azure DevOps中失败，测试框架引用方式致异常

问题描述 #

一批稳定运行多年的测试用例，约两天前突然开始失败。可复现于以下测试代码：

[TestMethod]
[ExpectedException(typeof(ArgumentException))]
public void TestException()
{
    throw new ArgumentException();
}

该测试在本地环境运行正常，但在Azure DevOps中执行失败，报错信息：

测试方法TestException抛出异常:
System.ArgumentException: 值不在预期范围内。

关键差异点 #

测试失败情况与Microsoft.VisualStudio.TestPlatform.TestFramework.dll的引用方式直接相关：

• 通过NuGet包引用该DLL的项目，在DevOps服务器上测试失败；
• 通过项目引用该DLL的项目，在DevOps服务器上测试正常。

原因分析 #

1. 版本不兼容：Azure DevOps测试代理可能最近更新了内置的测试运行器版本，与NuGet包引用的TestFramework版本存在兼容性冲突。项目引用使用的是本地一致的固定版本，因此不受影响。
2. NuGet缓存异常：DevOps代理的NuGet缓存中存储了错误版本的TestFramework包，导致还原时拉取了不兼容的版本，而非项目指定的版本。
3. 自动版本更新：项目未锁定TestFramework包的版本，两天前该包发布了新的不兼容版本，NuGet自动拉取后引发冲突。

解决办法 #

• 锁定NuGet包版本：在项目文件（.csproj）或NuGet.config中明确指定Microsoft.VisualStudio.TestPlatform.TestFramework的具体版本，与本地运行正常的版本保持一致。例如：

  <PackageReference Include="Microsoft.VisualStudio.TestPlatform.TestFramework" Version="17.8.0" />
  

• 清理DevOps代理NuGet缓存：在Azure DevOps构建管道中添加前置步骤，执行清理命令：

  dotnet nuget locals all --clear
  

  或针对旧版NuGet使用：

  nuget locals all -clear
  

• 验证测试任务配置：检查Azure DevOps中的VSTest任务（如VSTest@2），确保其使用的测试平台版本与项目依赖的TestFramework版本匹配，必要时在任务参数中指定testPlatformVersion。
• 回退到稳定版本：如果近期有自动更新TestFramework包的操作，将包版本回退到测试失败前的稳定版本。
• 临时改用项目引用：若需紧急恢复测试运行，可暂时将NuGet引用切换为项目引用，后续再排查NuGet版本问题。

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