使用Visual Studio运行Xunit测试时遇InvalidCastException反序列化错误

从你描述的情况来看，这个仅你本地出现的序列化异常，大概率是本地环境中残留的旧版Xunit组件与新版2.4.1的序列化逻辑冲突导致的——毕竟降级回2.3.1就正常，说明代码本身没问题，问题出在本地缓存或环境依赖上。下面是我整理的针对性排查和解决步骤：

1. 彻底清理Xunit相关本地缓存 #

关闭Visual Studio后，手动删除以下目录的内容（建议删除前备份，避免意外）：

• %USERPROFILE%\.nuget\packages\xunit*：删除所有xunit前缀的NuGet包缓存，确保后续还原的是纯净的2.4.1版本
• %USERPROFILE%\AppData\Local\Temp\xunit：Xunit测试运行器的临时缓存目录
• %USERPROFILE%\AppData\Local\Microsoft\VisualStudio\<你的VS版本号>\TestStore：Visual Studio测试运行器的本地存储缓存

2. 清理项目二进制文件和VS缓存 #

在解决方案目录下：

• 删除所有项目的bin、obj文件夹
• 删除隐藏的.vs文件夹（这个文件夹存储VS的解决方案级缓存）
• 重新打开Visual Studio，依次执行：解决方案 → 清理解决方案 → 解决方案 → 还原NuGet包 → 解决方案 → 重新生成解决方案

3. 确保Xunit测试运行器版本完全匹配 #

Xunit的VS测试运行器（xunit.runner.visualstudio）必须和你项目引用的Xunit版本严格一致：

• 打开测试项目的.csproj文件，检查PackageReference中xunit.runner.visualstudio的版本是否为2.4.1，和xunit、xunit.core版本保持统一
• 如果之前是通过VS扩展安装的测试运行器，建议卸载该扩展，改为通过NuGet包安装到测试项目中（这样能自动同步版本，避免扩展和项目包版本不一致）

4. 对齐本地.NET运行时环境 #

有时候不同版本的.NET SDK/Runtime会影响序列化行为：

• 打开命令行，执行dotnet --list-sdks和dotnet --list-runtimes，查看你本地的运行时版本
• 和团队其他成员对比，确保你安装的SDK/Runtime版本和他们一致，不一致的话下载安装对应版本

5. 排查依赖项冲突 #

检查测试项目是否存在混合版本的Xunit依赖：

• 执行dotnet list package --outdated查看所有依赖的版本情况，重点关注Xunit相关包（xunit、xunit.assert、xunit.core等）
• 如果发现有旧版本的依赖被间接引用，在.csproj文件中添加PackageReference强制指定版本为2.4.1，比如：

  <PackageReference Include="xunit.core" Version="2.4.1" />
  

为什么只有你遇到这个问题？ #

这种单用户环境问题，通常是因为你的本地缓存中残留了2.3.1版本的组件（比如NuGet缓存、VS测试缓存、未彻底清理的二进制文件），这些旧组件在新版Xunit运行时参与了序列化流程，导致类型转换失败。其他同事可能在升级时彻底清理了缓存，或者他们的环境原本就没有这些残留。

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