Blazor 怎么集成 FluentValidation

来源：这里教程网时间：2026-02-21 17:32:57 作者：

Blazor 中集成 FluentValidation 主要用于表单模型验证，提升客户端体验并保持服务端验证逻辑一致。核心思路是：用 FluentValidation 编写验证规则，再通过 Blazor 的

EditContext

和

DataAnnotationsValidator

（或自定义验证器）将规则接入表单生命周期。

1. 安装必要 NuGet 包

确保项目引用以下包：

FluentValidation（主库，如 v11+） FluentValidation.Blazor（官方支持包，v6+ 适配 .NET 6/7/8，含
FluentValidationValidator
组件）

运行命令（以 .NET 8 项目为例）：

dotnet add package FluentValidation
dotnet add package FluentValidation.Blazor

2. 创建验证器类

为你的模型（比如

Person

）编写继承自

AbstractValidator<t></t>

的验证器：

public class Person
{
    public string Name { get; set; } = string.Empty;
    public int Age { get; set; }
}
public class PersonValidator : AbstractValidator<Person>
{
    public PersonValidator()
    {
        RuleFor(x => x.Name).NotEmpty().MinimumLength(2);
        RuleFor(x => x.Age).InclusiveBetween(0, 150);
    }
}

推荐在 DI 容器中注册为 Singleton（验证器无状态，线程安全）：

builder.Services.AddFluentValidationClientsideAdapters();
builder.Services.AddSingleton, PersonValidator>();

3. 在 Blazor 组件中使用验证

在

.razor

文件中启用验证流程：

用
<editform></editform>
包裹表单，并绑定
EditContext
添加
<fluentvalidationvalidator></fluentvalidationvalidator>
（来自
FluentValidation.Blazor
）替代默认的
DataAnnotationsValidator
用
<validationsummary></validationsummary>
或
<validationmessage></validationmessage>
显示错误

示例：

@using FluentValidation.Blazor
<EditForm Model="@person" OnValidSubmit="HandleValidSubmit">
    <FluentValidationValidator />
    <ValidationSummary />
    <div>
        <InputText @bind-Value="person.Name" placeholder="姓名" />
        <ValidationMessage For="@(() => person.Name)" />
    </div>
    <div>
        <InputNumber @bind-Value="person.Age" placeholder="年龄" />
        <ValidationMessage For="@(() => person.Age)" />
    </div>
    <button type="submit">提交</button>
</EditForm>
@code {
    private Person person = new();
    private void HandleValidSubmit() => Console.WriteLine("提交成功");
}