ASP.NET Core MVC 自定义验证后端生效但前端不显示错误提示

核心现象 #

内置验证规则（如[Required]、[MinLength]、[MaxLength]）触发时，输入框下方可正常展示红色错误提示；但仅触发自定义[MustContainTags]规则时，后端已判定ModelState.IsValid为false并返回视图，前端却完全不展示对应错误提示，用户无法获知校验不通过的原因。

根因拆解 #

• 自定义验证返回结果未绑定关联字段
  原自定义验证类在构造ValidationResult时，只传入了错误消息文本，没有显式指定错误关联的成员名称。这类未指定成员的错误，会被记录到ModelState的模型根节点（对应key为空字符串），而前端视图中asp-validation-for="Message.Text"是绑定到Message.Text对应的节点读取错误，自然无法匹配到根节点上的错误信息，因此不会渲染提示。
• 自定义正则表达式存在语法错误
  原规则使用的正则@"($\w+)"中，未转义的$是字符串结束位置的元字符，放在正则起始位置永远无法匹配到内容，即便修复了错误展示问题，校验逻辑本身也不符合预期——若要匹配$开头的标签，需要对$做转义处理。

修复方案 #

1. 修正自定义验证类的错误返回逻辑
   重写IsValid方法时，返回错误结果必须显式关联当前验证的字段名，保证错误能被写入对应属性的ModelState节点。
   修正后的代码：

   public class MustContainTags : ValidationAttribute
   {
       protected override ValidationResult IsValid(object value, ValidationContext validationContext)
       {
           // 直接使用框架传入的当前属性值，无需重复从模型实例取值
           var text = value as string;
   
           if (string.IsNullOrEmpty(text))
               return new ValidationResult("This field is required.");
   
           // 修正正则：转义$字符，实现匹配$开头标签的逻辑
           if (Regex.Matches(text, @"\$\w+").Count == 0)
           {
               // 关键：传入当前验证的成员名称，将错误绑定到对应属性节点
               return new ValidationResult(
                   errorMessage: "Message must contain at least one tag.",
                   memberNames: new[] { validationContext.MemberName }
               );
           }
           
           return ValidationResult.Success;
       }
   }
   

2. （可选）适配客户端验证逻辑
   当前修复仅能保证后端校验失败返回视图时展示错误提示；若需要实现输入时即时校验、未通过时不提交表单的客户端验证效果，需要为自定义验证类实现IClientModelValidator接口，向客户端校验脚本传递自定义规则参数，配合前端JS完成校验逻辑对接。
3. 视图层注意验证范围配置
   原视图中注释关闭了asp-validation-summary="ModelOnly"，当前字段级错误提示的展示不依赖该配置；如果开启该配置，模型根节点的错误也会被统一汇总展示。

补充说明：内置验证规则能够正常展示错误，本质就是框架在返回错误时自动绑定了对应属性的节点，不会出现错误位置和读取位置不匹配的问题。

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