Blazor 集成 FluentValidation 可提升表单验证灵活性与可维护性，需注册服务、绑定 EditContext、支持异步及跨字段校验，并统一处理本地化错误展示。

Blazor 中集成 FluentValidation 能显著提升表单验证的灵活性和可维护性，尤其适合复杂业务规则场景。关键在于将服务注册、模型绑定、验证触发与 UI 反馈有机串联，而非简单套用传统 MVC 模式。

注册 FluentValidation 服务并启用客户端兼容模式

在 Program.cs（.NET 6+）中注册验证器时，需同时注入 FluentValidation 和适配 Blazor 的验证上下文支持：

• 调用 AddFluentValidation() 并配置 AutomaticValidationEnabled = false，避免服务端自动拦截干扰 Blazor 的手动验证流程
• 为每个需要验证的模型注册对应验证器，例如 services.AddFluentValidationClientsideAdapters();（需安装 FluentValidation.AspNetCore 或轻量版 FluentValidation.Blazor）
• 若使用服务器端渲染（SSR）或混合渲染，确保验证器支持 IValidator 接口且无依赖 HttpContext 等 Web 特定上下文

在 EditForm 中接入 FluentValidation 验证器

Blazor 的 EditForm 默认只识别 DataAnnotations，要使用 FluentValidation 必须通过自定义 EditContext 扩展：

• 创建验证器实例（如 new PersonValidator()），并将其挂载到 EditContext 的 OnValidationRequested 或使用第三方封装（如 FluentValidation.Blazor 提供的 FluentValidationValidator 组件）
• 在组件中声明 @inject IValidator PersonValidator，并在 OnInitialized 中绑定：editContext.SetValidator(PersonValidator);
• 确保模型属性有明确的 [DisplayName] 或在验证器中设置 WithName()，否则错误消息可能显示属性名而非友好名称

处理异步验证与跨字段/跨服务校验

FluentValidation 原生支持异步规则（MustAsync, CustomAsync），这在 Blazor 中特别适合检查用户名唯一性、邮箱可用性等场景：

• 在验证器中注入服务（如 IUserService），通过构造函数传入，并在 MustAsync 中调用 API 或数据库查询
• 注意：异步验证不会阻塞 UI，但需配合 ValidationMessage 和加载状态提示（例如用 IsBusy 控制按钮禁用或显示 spinner）
• 跨字段逻辑（如“结束时间必须晚于开始时间”）直接写在验证器的 RuleSet 或主规则中，无需额外 JS 或前端计算

统一错误展示与本地化支持

FluentValidation 的错误信息默认是英文字符串，Blazor 项目常需多语言支持：

• 使用 WithMessage(Localizer["EmailInvalid"]) 替代硬编码字符串，前提是验证器构造时注入 IStringLocalizer
• 推荐将验证器定义为作用域服务（Scoped），便于在构造函数中获取本地化器或当前文化信息
• 错误消息可通过 ValidationSummary 全局展示，也可结合 ValidationMessage For="@(() => model.Email)" 实现字段级精准反馈

基本上就这些。核心不是堆砌功能，而是让验证逻辑真正脱离 UI 层、可测试、可复用——FluentValidation 在 Blazor 里跑起来不难，难的是把它用得干净利落。