FluentValidation中ValidationContext重复使用导致错误信息重复问题解析

问题现象

在使用FluentValidation进行模型验证时，开发者可能会遇到一个典型问题：当多个验证器对同一个模型属性进行验证时，如果重复使用同一个ValidationContext实例，会导致验证错误信息被重复报告。

问题复现

假设我们有一个简单的模型类：

public class Model
{
    public string Prop { get; set; } = string.Empty;
    public string Other { get; set; } = string.Empty;
}

然后定义了两个验证器：

public class ModelValidator1 : AbstractValidator<Model>
{
    public ModelValidator1()
    {
        RuleFor(x => x.Prop).Matches(@"^\d+$").WithMessage("无效的Prop格式");
        RuleFor(x => x.Other).Matches(@"^\d+$").WithMessage("无效的Other格式");
    }
}

public class ModelValidator2 : AbstractValidator<Model>
{
    public ModelValidator2()
    {
        RuleFor(x => x.Prop).MinimumLength(10).WithMessage("长度太短");
    }
}

当开发者错误地重复使用同一个ValidationContext实例时：

var model = new Model() { Prop = "asdasd", Other = "12" };
var validators = new List<IValidator>() { new ModelValidator1(), new ModelValidator2() };

// 错误做法：重复使用同一个context
ValidationContext<Model> context = new ValidationContext<Model>(model);

var results = validators.Select(v => v.Validate(context));

输出结果会显示重复的错误信息：

无效的Prop格式
---------------
无效的Prop格式
长度太短
---------------

问题原因

这个问题的根本原因在于ValidationContext的设计机制。ValidationContext实例在验证过程中会累积验证错误信息，当同一个context被多个验证器使用时，每个验证器都会将自己的验证结果添加到同一个context中，导致错误信息被重复收集和报告。

解决方案

正确的做法是为每个验证器调用创建一个新的ValidationContext实例：

var model = new Model() { Prop = "asdasd", Other = "12" };
var validators = new List<IValidator>() { new ModelValidator1(), new ModelValidator2() };

// 正确做法：为每个验证器创建新的context
var results = validators.Select(v => v.Validate(new ValidationContext<Model>(model)));

最佳实践

1. 避免重用ValidationContext：每次验证都应该使用全新的ValidationContext实例
2. 考虑使用ValidateAsync：异步验证方法同样遵循这个原则，需要为每次验证创建新的context
3. 批量验证处理：当需要多个验证器验证同一个模型时，应该分别处理每个验证器的结果，而不是合并context

深入理解

ValidationContext不仅仅是验证的上下文环境，它还承担着收集和跟踪验证状态的重要职责。这包括：

• 维护验证过程中的错误集合
• 跟踪已经验证过的属性
• 存储自定义的验证状态数据

正是由于这些职责，使得ValidationContext不能被安全地重复使用。理解这一点对于正确使用FluentValidation至关重要。

总结

FluentValidation是一个功能强大且灵活的验证库，但正确使用其核心组件是确保验证行为符合预期的关键。通过遵循"每次验证使用新context"的原则，可以避免错误信息重复等常见问题，确保验证结果的准确性和可靠性。