Fluent Assertions 6.0 升级指南：关键变更与技术解析-CSDN博客

本文链接：https://blog.csdn.net/gitblog_00503/article/details/148552568

Fluent Assertions 6.0 升级指南：关键变更与技术解析

前言

Fluent Assertions 6.0 版本带来了一系列重要的架构改进和功能优化，同时也包含了一些必要的破坏性变更。本文将从技术角度深入解析这些变更，帮助开发者顺利升级到新版本。

枚举断言的重构

在 5.x 版本中，枚举断言由 ObjectAssertions 类处理，这种设计存在几个明显问题：

许多通用断言方法（如 BeNull）对枚举类型没有实际意义
枚举专用方法 HaveFlag 却对所有引用类型都可见
类型安全性不足，允许不同枚举类型间的错误比较

新版改进

6.0 版本引入了专门的 EnumAssertions 和 NullableEnumAssertions 类，提供了更精确的类型安全断言：

// 6.0 正确用法
MyEnum.One.Should().Be(MyEnum.One); // 编译通过
MyEnum.One.Should().Be(1);         // 编译错误

新增的专用方法：

HaveSameValueAs：比较底层数值
HaveSameNameAs：比较枚举名称
HaveValue：验证特定数值

等效性比较改进

对象图比较中的枚举处理更加严格：

// 5.x 可以通过的断言，6.0 将失败
var subject = new { Value = "One" };
var expectation = new { Value = MyOtherEnum.One };
subject.Should().BeEquivalentTo(expectation);

必须明确指定比较方式：

subject.Should().BeEquivalentTo(expectation, opt => opt.ComparingEnumsByName());

等效性验证架构改进

6.0 对 IEquivalencyStep 进行了重大重构：

将验证上下文中的主体和期望值分离到新的 Comparands 类型
移除了 CanHandle 方法
将 Handle 的布尔返回值改为更明确的 EquivalencyResult 枚举

新的基类 EquivalencyStep<T> 简化了自定义步骤的实现。

Using 方法的类型安全增强

5.x 版本中 Using<TProperty> 和 WhenTypeIs<TMemberType> 之间缺乏类型约束，可能导致运行时错误。6.0 增加了编译时类型检查：

// 5.x 编译通过但运行时失败
.Using<int>(e => ...).WhenTypeIs<string>()

// 6.0 直接编译错误

同时修复了可空值类型的处理问题，确保 null 和 0 不再被错误地等同。

值格式化器性能优化

IValueFormatter 接口进行了重构以提高大型对象图的格式化性能：

不再返回字符串，而是使用 FormattedObjectGraph 构建输出
支持更精细的格式化控制
改进深度限制处理

示例格式化器实现：

public void Format(object value, FormattedObjectGraph graph, FormattingContext context)
{
    string result = "\"" + value + "\"";
    if (context.UseLineBreaks)
        graph.AddFragmentOnNewLine(result);
    else
        graph.AddFragment(result);
}

集合断言改进

6.0 移除了对非泛型集合的支持：

IEnumerable subject;
subject.Should().HaveCount(42); // 不再编译
subject.Cast<object>().Should().HaveCount(42); // 正确用法

同时移除了 BeEquivalentTo(params object[]) 重载，以保持类型一致性。

异步异常断言

6.0 完全拥抱异步编程模型，不再自动同步阻塞异步代码：

// 5.x 可用但不推荐
asyncMethod.Should().Throw<Exception>();

// 6.0 正确用法
await asyncMethod.Should().ThrowAsync<Exception>();

这一变更避免了潜在的同步上下文死锁问题。

事件断言链式调用变更

事件约束方法（如 WithArgs）现在只返回匹配的事件，改变了链式调用行为：

// 5.x 方式（6.0不再工作）
foo.ShouldRaise("Event")
   .WithArgs<string>(x => x == "a")
   .WithArgs<string>(x => x == "b");

// 6.0 正确方式
foo.ShouldRaise("Event").WithArgs<string>(x => x == "a");
foo.ShouldRaise("Event").WithArgs<string>(x => x == "b");