TUnit测试框架中的部分等效性断言优化方案

在单元测试中，我们经常需要对复杂对象进行断言验证，但有时我们只关心对象的部分属性而非全部。TUnit测试框架目前提供的IsEquivalentTo断言要求实际对象必须与预期对象具有完全相同的结构，这在某些测试场景下显得过于严格。

当前限制分析

现有实现中，当使用等效性断言时，如果实际对象包含预期对象中不存在的成员，断言会立即失败。例如：

public record Something(string StringValue, int IntValue);

[Test]
public async Task SampleTest()
{
   var something = new Something("Test", 42);
   
   // 当前会因IntValue不存在于预期对象而失败
   await Assert.That(something)
         .IsEquivalentTo(new
         {
             StringValue = "Test",
         });
}

虽然框架提供了IgnoringMembers方法可以忽略特定成员，但对于包含大量属性的对象，这种方法会变得冗长且难以维护。

解决方案设计

为解决这一问题，我们可以引入部分等效性检查的概念。具体实现方案包括：

1. 新增断言选项：通过枚举参数明确指定断言类型

   await Assert.That(something)
         .IsEquivalentTo(new { StringValue = "Test" }, 
             AssertionMode.PartialEquivalence);
   

2. 实现逻辑：

   • 仅比较预期对象中存在的属性
   • 忽略实际对象中多出的属性
   • 保持现有深度比较逻辑对于共有属性的验证

3. 错误报告：当预期对象的属性在实际对象中不存在时，仍应报告错误

技术实现要点

在TUnit框架内部，等效性比较是通过反射实现的。修改时需要：

1. 在比较前过滤属性集合，只保留预期对象中存在的属性
2. 保持现有的类型转换和嵌套对象比较逻辑
3. 确保新功能与现有的IgnoringMembers方法兼容
4. 提供清晰的错误信息，指出是哪个属性导致了不匹配

使用场景建议

这种部分等效性检查特别适用于：

• 只验证DTO中的关键字段
• 测试返回大型对象但只关心少数属性的API
• 避免测试因无关字段变更而频繁失败
• 处理包含动态或运行时生成属性的对象

总结

通过引入部分等效性断言，TUnit框架可以为开发者提供更灵活的测试验证方式，同时保持代码的清晰性和可维护性。这一改进将使得测试代码能够更精确地表达测试意图，减少不必要的验证代码，提高测试的稳定性和可读性。