FluentValidation在ASP.NET Core中手动验证的正确使用方式

背景介绍

FluentValidation是一个流行的.NET验证库，它提供了优雅的方式来定义业务对象的验证规则。在ASP.NET Core应用中，开发者通常会面临两种验证方式的选择：自动验证和手动验证。

核心问题

许多开发者在从FluentValidation.AspNetCore迁移到纯手动验证时存在困惑，特别是关于是否需要继续依赖FluentValidation.AspNetCore包。文档中的某些细节表述不够清晰，导致开发者对验证方法的正确实现产生疑问。

手动验证的正确实践

1. 不再需要FluentValidation.AspNetCore

最新版本的FluentValidation已经明确表示，FluentValidation.AspNetCore包不再维护，推荐开发者完全转向手动验证方式。这意味着：

• 项目只需引用核心的FluentValidation包
• 不再需要任何与ASP.NET Core集成的特定包
• 完全控制验证流程和错误处理

2. 手动验证的实现方式

在控制器中实现手动验证的标准模式如下：

public class MyController : Controller
{
    private readonly IValidator<Person> _validator;
    
    public MyController(IValidator<Person> validator)
    {
        _validator = validator;
    }
    
    public IActionResult Create(Person person)
    {
        var result = _validator.Validate(person);
        
        if (!result.IsValid)
        {
            // 自定义错误处理逻辑
            foreach(var error in result.Errors)
            {
                ModelState.AddModelError(error.PropertyName, error.ErrorMessage);
            }
            return View(person);
        }
        
        // 验证通过的处理逻辑
        return RedirectToAction("Success");
    }
}

3. 替代AddToModelState的解决方案

虽然FluentValidation.AspNetCore提供了方便的AddToModelState扩展方法，但在手动验证模式下，我们可以：

1. 完全按照上述示例自行处理错误
2. 或者将文档中提供的扩展方法代码复制到项目中：

public static class Extensions
{
    public static void AddToModelState(this ValidationResult result, 
        ModelStateDictionary modelState, string prefix)
    {
        foreach (var error in result.Errors)
        {
            modelState.AddModelError(error.PropertyName, error.ErrorMessage);
        }
    }
}

最佳实践建议

1. 完全移除FluentValidation.AspNetCore依赖：确保项目只引用核心FluentValidation包

2. 明确验证控制权：手动验证让开发者完全掌控验证时机和错误处理方式

3. 自定义错误处理：根据业务需求灵活处理验证失败的情况

4. 保持代码一致性：在整个项目中采用统一的手动验证模式

总结

FluentValidation在ASP.NET Core中的最佳实践已经转向完全手动验证的方式。开发者应该摆脱对FluentValidation.AspNetCore包的依赖，采用更灵活、更可控的手动验证模式。这种方式不仅更符合现代ASP.NET Core的设计理念，还能提供更好的灵活性和控制力。

通过理解核心验证机制并实现自定义的错误处理逻辑，开发者可以构建更健壮、更易维护的Web应用程序。