FluentValidation在ASP.NET Core中的手动验证实践

前言

在ASP.NET Core应用开发中，数据验证是一个至关重要的环节。FluentValidation作为.NET生态中广受欢迎的验证库，提供了优雅的链式API来定义复杂的验证规则。随着FluentValidation.AspNetCore包的弃用，开发者需要了解如何正确地在ASP.NET Core中实现手动验证。

FluentValidation.AspNetCore包的现状

FluentValidation团队已明确表示不再维护FluentValidation.AspNetCore包，并建议开发者转向使用核心FluentValidation包配合手动验证的方式。这一变化让许多开发者产生了困惑，特别是在文档中关于包依赖关系的描述不够清晰。

手动验证的实现方式

手动验证的核心思想是开发者自行控制验证流程，而不是依赖自动化的模型绑定验证。这种方式提供了更大的灵活性，特别是在需要自定义验证逻辑或错误处理时。

基本实现步骤

1. 定义验证器类：继承自AbstractValidator，在其中定义验证规则
2. 在控制器中注入验证器：通过依赖注入获取验证器实例
3. 执行验证：手动调用验证器的Validate方法
4. 处理验证结果：根据验证结果决定后续流程

验证结果处理

在手动验证中，开发者需要自行处理验证结果到ModelState的转换。FluentValidation.AspNetCore包中提供的AddToModelState扩展方法虽然方便，但并非必需。实际上，可以很容易地自行实现类似功能：

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

为什么推荐手动验证

手动验证相比自动验证具有以下优势：

1. 更明确的控制流：验证过程完全可见，便于调试和维护
2. 更好的灵活性：可以根据业务需求定制验证逻辑和错误处理
3. 减少魔法行为：避免框架自动行为带来的意外问题
4. 更轻量的依赖：无需引入额外的包，减少项目依赖

实际应用建议

在实际项目中，可以考虑以下实践：

1. 创建基础控制器或中间件来封装常见的验证逻辑
2. 为验证错误设计统一的API响应格式
3. 在复杂场景中组合多个验证器的结果
4. 考虑使用MediatR等模式将验证逻辑从控制器中分离

总结

随着FluentValidation.AspNetCore包的弃用，手动验证成为了ASP.NET Core项目中更推荐的验证方式。虽然需要编写更多的代码，但这种方式提供了更好的可控性和灵活性。开发者可以完全掌控验证流程，根据项目需求定制验证行为，同时保持代码的清晰和可维护性。