MudBlazor禁用Fluent Validation规则后数据注解验证生效的解决办法

问题场景 #

在MudBlazor的MudForm中使用Fluent Validation实现客户端验证，通过.When()方法动态禁用特定规则时，实体类上的DataAnnotation验证（如[StringLength]）会在客户端自动生效，不符合“客户端仅用Fluent Validation，DataAnnotation仅服务端使用”的需求。

相关代码示例：

MudForm配置 #

<MudBlazor.MudForm Model="person" @onsubmit="ValidSubmit" @ref="frmMain"
                   @bind-Errors="@errors" OverrideFieldValidation="true"
                   Validation="@(modelValidator.ValidateValue)">

Fluent Validation规则 #

RuleFor(x => x.User.UserName)
    .MaximumLength(50).When(x => (Person != null && Person.User != null && UserEditable))
    .WithMessage("...");

实体类DataAnnotation #

[StringLength(50)]
public string UserName { get; set; } = string.Empty;

MudTextField组件 #

<MudBlazor.MudTextField Label="User Name"
                        For="(() => person.User.UserName)" @bind-Value="Person.UserName" Class="mb-4 d-block w-100" Immediate="true"
                        Variant="MudBlazor.Variant.Text"
                        autocomplete="new-password"
                        Disabled="!IsEditable">      

</MudBlazor.MudTextField> 

解决方案 #

1. 设置MudForm的ValidationMode为Custom #

MudForm默认会同时启用DataAnnotation和自定义验证，需要通过ValidationMode强制仅使用自定义验证逻辑：

<MudBlazor.MudForm Model="person" @onsubmit="ValidSubmit" @ref="frmMain"
                   @bind-Errors="@errors" OverrideFieldValidation="true"
                   Validation="@(modelValidator.ValidateValue)"
                   ValidationMode="ValidationMode.Custom">

ValidationMode.Custom会让MudForm完全忽略DataAnnotation验证，只执行你指定的Fluent Validation逻辑。

2. 禁用MudTextField的独立验证 #

部分MudBlazor组件会自带DataAnnotation验证逻辑，需要显式禁用，让组件完全依赖父表单的验证：

<MudBlazor.MudTextField Label="User Name"
                        For="(() => person.User.UserName)" @bind-Value="Person.UserName" Class="mb-4 d-block w-100" Immediate="true"
                        Variant="MudBlazor.Variant.Text"
                        autocomplete="new-password"
                        Disabled="!IsEditable"
                        Validation="null">      
</MudBlazor.MudTextField> 

Validation="null"会取消TextField自身的验证逻辑，确保只有Fluent Validation的规则生效。

3. 优化Fluent Validation规则条件 #

检查.When()的条件是否准确，避免冗余判断（比如原代码中Person != null是多余的，因为x就是当前验证的Person实例）：

RuleFor(x => x.User.UserName)
    .MaximumLength(50).When(x => x.User != null && UserEditable)
    .WithMessage("用户名长度不能超过50个字符");

内容的提问来源于stack exchange，提问作者mz1378