FluentAssertions：如何为断言失败消息添加带参数的自定义前缀？

针对你的需求，FluentAssertions完全可以实现为参数化测试的断言失败消息动态添加包含测试参数的前缀，无需重复编写测试用例，也不会破坏断言消息的语义。以下是几种实用方案：

方案一：使用AssertionScope动态注入测试参数前缀 #

AssertionScope的字符串参数支持动态拼接，你可以在测试方法开头创建一个包含当前DataRow参数的Scope，该Scope内的所有断言失败都会自动带上这个前缀：

[DataTestMethod]
[DataRow("用户A", 100)]
[DataRow("用户B", 200)]
public void VerifyUserScore(string userName, int score)
{
    // 动态生成包含测试参数的Scope前缀
    using var assertionScope = new AssertionScope($"测试参数：用户名={userName}, 分数={score}");

    // 执行断言，失败消息会自动带上Scope前缀
    score.Should().Be(150, "因为该用户的预期分数为150");
    userName.Should().StartWith("测试用户");
}

当断言失败时，消息会先显示Scope的参数前缀，再展示具体断言的失败原因，完全保留原有断言的语义，同时补充了测试的上下文信息。

方案二：自定义FluentAssertions扩展方法 #

如果不想每个测试都手动创建Scope，可以编写一个扩展方法，为单个断言添加测试参数上下文：

public static class FluentAssertionsExtensions
{
    // 针对引用类型断言的扩展
    public static AndConstraint<TAssertions> WithTestParams<TAssertions, T>(
        this AndConstraint<TAssertions> constraint, string paramInfo)
        where TAssertions : ReferenceTypeAssertions<T, TAssertions>
    {
        constraint.Because += $" [测试参数：{paramInfo}]";
        return constraint;
    }

    // 针对值类型断言的扩展
    public static AndConstraint<TAssertions> WithTestParams<TAssertions, T>(
        this AndConstraint<TAssertions> constraint, string paramInfo)
        where TAssertions : ValueTypeAssertions<T, TAssertions>
    {
        constraint.Because += $" [测试参数：{paramInfo}]";
        return constraint;
    }
}

在测试中使用该扩展：

[DataTestMethod]
[DataRow("商品X", 99.9)]
[DataRow("商品Y", 199.9)]
public void VerifyProductPrice(string productName, decimal price)
{
    var paramInfo = $"商品名={productName}, 价格={price}";
    
    price.Should().Be(149.9).WithTestParams(paramInfo);
    productName.Should().Contain("特价").WithTestParams(paramInfo);
}

这种方式可以灵活控制哪些断言需要添加参数上下文，失败消息会在原有原因后追加测试参数信息。

关键说明 #

你之前担心AssertionScope的字符串是硬编码，但实际上它支持动态拼接DataRow的参数值，完全可以根据当前测试的输入生成个性化前缀，既复用了参数化测试的优势，又解决了失败消息缺乏上下文的问题。

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