.NET 5 xUnit测试QueryResultSummary对象跨类赋值冲突导致批量执行失败

问题根源 #

xUnit默认开启测试类级别的并行执行，单类运行通过、全量运行失败的赋值冲突问题，本质是测试用例之间的共享可变资源未做隔离，多个并行测试同时修改同一个实例的属性，导致预期值被其他测试覆盖。

排查步骤 #

• 检查测试类字段定义：确认代码中的getSiteQueryMoq、sut（被测系统实例）是否被static修饰，静态变量会被所有测试用例共享，并行执行时会被互相覆盖赋值。
• 检查共享Fixture使用：如果你的测试类实现了IClassFixture<T>/ICollectionFixture<T>，并且将Moq实例、QueryResultSummary实例存放在了共享Fixture中，同一集合内的测试会共用同一个可变实例，引发赋值冲突。
• 检查被测代码静态变量：确认GetSite方法的依赖类中，是否存在QueryResultSummary类型的静态字段，全局静态实例会被所有测试请求修改，导致返回值异常。

解决方法 #

1. 验证是否为并行冲突（临时验证）
   在测试项目根目录新建xunit.runner.json文件，添加如下配置关闭并行执行，如果全量运行测试全部通过，即可实锤是共享资源隔离问题：

{
  "parallelizeTestCollections": false
}

2. 实现测试依赖隔离（根本解决方案）
   所有可变的Moq对象、SUT实例都要保证每个测试用例独有，不要用静态修饰，也不要放到共享Fixture中：

// 正确写法：每个测试的Arrange阶段单独初始化依赖
[Fact]
public async Task ShouldReturn_SiteWithStatusDataView_Type_IfExist()
{
    // Arrange 阶段新建所有依赖
    var getSiteQueryMoq = new Mock<IGetSiteQuery>();
    var sut = new 你的被测服务类(getSiteQueryMoq.Object);
    // 剩余原有Arrange逻辑不变
}

如果多个测试方法共用初始化逻辑，可以将初始化代码放到测试类的构造函数中，xUnit每次执行测试方法前都会新建一个测试类实例，构造函数中初始化的实例是相互隔离的。

3. 优化Fixture配置
   你之前的Fixture自定义规则中RecordsCount绑定了exemptions变量，如果exemptions是共享变量，会导致不同测试生成的QueryResultSummary值异常。如果不需要自动生成该类实例，可以直接手动实例化（和你现有写法一致），无需通过Fixture创建，避免全局自定义规则的影响。

4. 断言优化（可选）
   如果CustomMessage中包含动态生成的时间值，你可以用FluentAssertions的排除配置避免格式差异导致的断言失败：

extractedActualResult.Should().BeEquivalentTo(expectedResult, opt => 
    opt.Excluding(x => x.Item2.CustomMessage)
);
// 单独校验CustomMessage的格式
extractedActualResult.Item2.CustomMessage.Should().StartWith("Request, Processed With Provided LastDateTime:");

内容的提问来源于stack exchange，提问作者K.Z