Blazor Server vs WebAssemblyBlazored.FluentValidation 两种托管模型的验证器配置指南【免费下载链接】FluentValidationA library for using FluentValidation with Blazor项目地址: https://gitcode.com/gh_mirrors/flue/FluentValidation在 Blazor 开发中表单校验几乎是每个页面的刚需而Blazored.FluentValidation正是把 FluentValidation 无缝接入 Blazor 表单的最佳方案之一。不过很多新手在配置时都会遇到同一个困惑Blazor Server 和 Blazor WebAssembly 两种托管模型下验证器的配置方式似乎不太一样这篇指南将从两种托管模型的核心差异出发一步步带你完成验证器配置并避开常见的大坑。为什么需要 Blazored.FluentValidationFluentValidation 本身是独立的 .NET 校验库它并不认识 Blazor 的EditForm和EditContext。Blazored.FluentValidation 的角色就是充当两者之间的翻译官它提供一个FluentValidationValidator组件只需放进EditForm内部即可自动挂钩验证流程它自动把 FluentValidation 的校验错误映射到ValidationMessage、ValidationSummary上它支持程序集扫描Assembly Scanning也支持手动通过依赖注入DI注册验证器。核心实现位于 FluentValidationsValidator.cs 与 EditContextFluentValidationExtensions.cs前者负责组件与EditContext的对接后者负责真正执行验证逻辑。理解这两份源码配置时就能做到心中有数。两种托管模型的本质区别先分清再配置 Blazor 有两种托管方式运行环境完全不同这直接决定了验证器在哪跑、怎么找对比维度Blazor ServerBlazor WebAssembly代码运行位置服务端服务器浏览器端客户端验证器注册方式推荐 DI 注册通常依赖程序集扫描程序集扫描可用扫描服务端程序集可用扫描浏览器程序集异步验证规则可在服务端直接执行往往需要调用 Web API适用场景内部系统、实时交互静态托管、离线友好、降低服务器压力简单说Blazor Server 的验证器运行在你的服务器上Blazor WebAssembly 的验证器运行在用户的浏览器里。这个差异决定了下面两种完全不同的配置路径。Blazor Server 验证器配置依赖注入注册一步到位 ⚙️在 Blazor Server 中最推荐的验证器配置方式是通过依赖注入注册验证器因为服务端天然拥有完整的 DI 容器。第一步在 Program.cs 中注册验证器打开samples/BlazorServer/Program.cs可以看到官方示例的核心注册代码builder.Services.AddTransientIValidatorPerson, PersonValidator(); builder.Services.AddTransientIValidatorAddress, AddressValidator();把验证器注册为IValidatorT的实现Blazored.FluentValidation 在验证时会自动从容器中解析出对应的验证器。第二步在页面组件中引用在EditForm内部放置FluentValidationValidator并显式关闭程序集扫描因为验证器已通过 DI 注册无需再扫描EditForm Model_person OnValidSubmitSubmitValidForm FluentValidationValidator ref_fluentValidationValidator DisableAssemblyScanningtrue/ ValidationSummary/ InputText bind-Value_person.FirstName / ValidationMessage For(() _person.FirstName) / ... /EditForm参考示例页面samples/BlazorServer/Pages/Index.razor模型与验证器定义在samples/Shared/SharedModels/Person.cs中。 关闭程序集扫描DisableAssemblyScanningtrue可以避免每次验证都扫描程序集这是 Blazor Server 配置中最值得养成的性能习惯。Blazor WebAssembly 验证器配置程序集扫描自动发现 Blazor WebAssembly 运行在浏览器中虽然也有自己的 DI 容器但官方示例更倾向使用程序集扫描不手动注册验证器而是让库自动发现。为什么 WASM 默认靠扫描打开samples/BlazorWebAssembly/Program.cs你会发现它没有注册任何验证器只配置了HttpClient等基础服务。那验证器从哪来答案在 EditContextFluentValidationExtensions.cs 的GetValidatorForModel方法中它遍历AppDomain.CurrentDomain.GetAssemblies()用FindValidatorsInAssembly找出实现了IValidatorT的类型并自动实例化。所以 WASM 示例中的页面组件直接这样用EditForm Model_person OnSubmitSubmitFormAsync FluentValidationValidator ref_fluentValidationValidator Options(options options.IncludeAllRuleSets()) / ValidationSummary/ ... /EditForm参考samples/BlazorWebAssembly/Pages/Index.razor无需注册即可生效这就是程序集扫描的便利之处。⚠️ 也可以像 Server 那样在 WASM 的Program.cs里手动注册验证器但要注意WASM 程序集的加载时机、裁剪Trim设置可能影响扫描结果因此更稳妥的做法是保持验证器与组件在同一程序集内。两种托管模型通用的组件配置Options 与手动验证 ✅无论哪种托管模型FluentValidationValidator的以下配置都是通用的用 Options 控制验证范围RuleSetsFluentValidation 的 RuleSet 机制可以按场景分组校验例如 PersonValidator 中把姓名字段归入Names规则集FluentValidationValidator Options(options options.IncludeRuleSets(Names).IncludeRulesNotInRuleSet())/内部实现上库会通过ValidationContext.CreateWithOptions构造带筛选器的上下文并借助IntersectingCompositeValidatorSelector把字段级验证与整体验证合并相关源码见 IntersectingCompositeValidatorSelector.cs。手动触发验证通过ref拿到组件实例后可以调用// 同步验证 _fluentValidationValidator.Validate(); // 异步验证等所有异步规则完成 await _fluentValidationValidator!.ValidateAsync();这在点击按钮做部分校验的场景中非常实用示例见两个 samples 页面中的PartialValidate方法。异步验证规则两种托管模型的差异处理 ⏱️FluentValidation 支持MustAsync等异步规则但在两种托管模型下的执行环境截然不同Blazor Server异步规则直接在服务端执行可以访问数据库、文件系统等资源实现最简单Blazor WebAssembly异步规则在浏览器中执行无法直接访问服务端资源通常需要把校验逻辑封装为 Web API在异步规则内部通过HttpClient调用。官方示例的PersonValidator中就用MustAsync模拟了一个邮箱唯一性校验samples/Shared/SharedModels/Person.csRuleFor(p p.EmailAddress) .NotEmpty().WithMessage(You must enter an email address) .EmailAddress().WithMessage(You must provide a valid email address) .MustAsync(async (email, _) await IsUniqueAsync(email)) .WithMessage(Email address must be unique); 新手建议如果项目是 WASM 且异步规则需要访问数据库优先把校验下沉到 Web API前端只做格式校验这样既安全又省流量。新手避坑指南5 个常见问题速查表 ️常见问题原因解决办法表单不校验直接提交忘记在EditForm内放置FluentValidationValidator检查组件是否在EditForm标签内部报错需要 cascading EditContext 参数组件放到了EditForm外面把组件移回EditForm内部验证器没生效ServerDI 未注册IValidatorT在Program.cs添加AddTransient注册验证器没生效WASM程序集扫描找不到验证器确认验证器与页面在同一程序集或手动注册首次验证缓慢开启了程序集扫描且未禁用DI 注册后设置DisableAssemblyScanningtrue总结如何为你的项目选择配置方式 Blazor Server 项目优先使用依赖注入注册验证器并关闭程序集扫描性能最优、结构最清晰Blazor WebAssembly 项目小型项目可直接享受程序集扫描的零配置便利大型项目建议显式注册并规划好共享模型与验证器所在的项目引用两种模型共用一套模型把模型与验证器放到独立的类库如samples/Shared/SharedModels两端项目引用同一份校验规则维护成本最低。掌握了 Blazor Server 与 Blazor WebAssembly 两种托管模型的验证器配置差异你就能在 Blazor 项目中游刃有余地使用 FluentValidation 完成表单校验。动手打开项目里的两个示例跑一遍对比体验会更深哦【免费下载链接】FluentValidationA library for using FluentValidation with Blazor项目地址: https://gitcode.com/gh_mirrors/flue/FluentValidation创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考