MVC自定义Required验证属性IsValid方法未触发问题求助

我来帮你排查并解决这个问题，你遇到的情况其实是MVC自定义验证中几个常见的坑点导致的，咱们一步步来拆解和修复：

一、为什么IsValid()方法没被调用？ #

最核心的原因是你没有在Controller的Action中触发服务器端验证——MVC的服务器端验证逻辑只有在你检查ModelState.IsValid时才会执行，它会遍历模型上的所有验证属性并调用它们的IsValid方法。之前你提到"未使用ModelState.IsValid"，这直接导致服务器端的自定义验证完全没触发。

另外，你的自定义验证属性还有两个小问题：

1. ValidationType用了"required"，会和MVC默认的Required验证规则冲突，导致客户端验证逻辑混乱；
2. 没有实现正确的空格处理逻辑，这也是你最初需要自定义验证的原因。

二、完整解决方案 #

1. 修正自定义验证属性 #

重新实现CustomRequiredValidatorAttribute，确保服务器端逻辑正确，同时避免客户端冲突：

[AttributeUsage(AttributeTargets.Property)]
public class CustomRequiredValidatorAttribute : ValidationAttribute, IClientValidatable
{
    // 服务器端验证逻辑：处理全空格情况
    public override bool IsValid(object value)
    {
        if (value is string strValue)
        {
            // 修剪空格后检查是否为空或仅空格
            return !string.IsNullOrWhiteSpace(strValue.Trim());
        }
        // 非字符串类型，仅检查是否为null
        return value != null;
    }

    // 客户端验证规则配置
    public IEnumerable<ModelClientValidationRule> GetClientValidationRules(ModelMetadata metadata, ControllerContext context)
    {
        if (metadata == null)
        {
            throw new ArgumentNullException(nameof(metadata));
        }

        var rule = new ModelClientValidationRule
        {
            // 优先使用自定义错误信息，否则用默认提示
            ErrorMessage = ErrorMessage ?? "此字段为必填项，且不能仅包含空格",
            // 使用自定义验证类型，避免和默认required冲突
            ValidationType = "customrequired"
        };

        yield return rule;
    }
}

2. 更新模型 #

将自定义属性应用到模型字段：

public class Employee
{
    [CustomRequiredValidator(ErrorMessage = "姓名不能为空，且不能仅包含空格")]
    [RegularExpression(@"^[a-zA-Z0-9\s]+$", ErrorMessage = "姓名格式只能包含字母、数字和空格")]
    public string Name { get; set; }
}

3. 在Controller中触发服务器端验证 #

必须在Action中检查ModelState.IsValid，这样才会调用自定义验证的IsValid方法：

[HttpPost]
public ActionResult SaveEmployee(Employee model)
{
    if (ModelState.IsValid)
    {
        // 验证通过，执行保存逻辑
        return Json(new { success = true, message = "员工信息保存成功" });
    }
    // 验证失败，收集所有错误信息返回
    var errorMessages = ModelState.Values
        .SelectMany(v => v.Errors)
        .Select(e => e.ErrorMessage);
    return Json(new { success = false, errors = errorMessages });
}

4. 配置客户端无刷新验证 #

要实现无页面刷新验证，需要注册自定义的jQuery验证规则，确保客户端和服务器端逻辑一致：

在你的View（或布局页）中添加以下脚本（确保已经引入jquery.validate.min.js和jquery.validate.unobtrusive.min.js）：

<script src="~/Scripts/jquery.validate.min.js"></script>
<script src="~/Scripts/jquery.validate.unobtrusive.min.js"></script>
<script>
    // 注册自定义客户端验证方法
    $.validator.addMethod("customrequired", function (value, element) {
        // 客户端逻辑：修剪空格后检查是否为空
        return this.optional(element) || $.trim(value) !== "";
    }, "此字段为必填项，且不能仅包含空格");

    // 注册非侵入式验证适配器，让MVC识别自定义规则
    $.validator.unobtrusive.adapters.add("customrequired", [], function (options) {
        options.rules["customrequired"] = true;
        options.messages["customrequired"] = options.message;
    });
</script>

5. 编写无刷新提交的View #

使用Ajax.BeginForm实现无刷新提交，同时显示验证错误：

@model Employee

@using (Ajax.BeginForm("SaveEmployee", "Employee", new AjaxOptions {
    HttpMethod = "POST",
    OnSuccess = "handleSaveSuccess",
    OnFailure = "handleSaveFailure"
}, new { @class = "form-horizontal" }))
{
    @Html.AntiForgeryToken()

    <div class="form-group">
        @Html.LabelFor(m => m.Name, new { @class = "col-sm-2 control-label" })
        <div class="col-sm-10">
            @Html.TextBoxFor(m => m.Name, new { @class = "form-control" })
            @Html.ValidationMessageFor(m => m.Name, "", new { @class = "text-danger" })
        </div>
    </div>

    <div class="form-group">
        <div class="col-sm-offset-2 col-sm-10">
            <button type="submit" class="btn btn-primary">保存</button>
        </div>
    </div>
}

<script>
    function handleSaveSuccess(response) {
        if (response.success) {
            alert(response.message);
            // 重置表单
            $('form')[0].reset();
            // 清除验证状态
            $('form').validate().resetForm();
        } else {
            // 可以手动遍历错误并显示，不过非侵入式验证会自动处理输入框的错误提示
            alert(response.errors.join("\n"));
        }
    }

    function handleSaveFailure() {
        alert("请求失败，请稍后重试");
    }
</script>

三、关键注意事项 #

• 必须检查ModelState.IsValid：这是服务器端验证触发的开关，没有它，自定义验证的IsValid方法永远不会被调用；
• 避免ValidationType冲突：不要使用MVC内置的验证类型名称（比如"required"、"email"），否则会覆盖默认规则导致混乱；
• 客户端与服务器端逻辑一致：确保客户端的验证逻辑和服务器端IsValid的逻辑完全匹配，避免出现客户端通过但服务器端拒绝的情况。

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