如何创建通用自定义Model Binder以忽略间接字段验证

我完全懂你遇到的这个坑——默认的Model Binder会递归验证所有嵌套模型的属性，哪怕你只是想绑定嵌套模型的Id，它也会揪着子模型的Required字段不放，导致ModelState平白无故报错。下面我给你分享一个通用的自定义Model Binder实现，以及轻量替代方案：

问题根源 #

默认Model Binder在处理嵌套复杂类型时，会完整实例化子模型并触发其所有数据注解验证（比如[Required]）。就像你的例子里，绑定Model2时，哪怕你只传了Model1.Id，它还是会检查Model1的Name和Type是否为空，这显然不是你想要的——你只关心Model2自己的直接字段是否符合要求，以及嵌套的Model1是否被选中（即Id有值）。

通用自定义Model Binder实现 #

这个Binder的思路很简单：先让默认绑定器完成绑定工作，然后手动清理ModelState中属于嵌套子模型的验证错误，只保留当前目标模型的直接字段错误。

1. 编写自定义Binder类 #

public class DirectPropertiesOnlyModelBinder : DefaultModelBinder
{
    public override object BindModel(ControllerContext controllerContext, ModelBindingContext bindingContext)
    {
        // 先让默认绑定器完成绑定和验证
        var boundModel = base.BindModel(controllerContext, bindingContext);
        
        // 获取当前目标模型的所有直接属性名称
        var directPropertyNames = TypeDescriptor.GetProperties(bindingContext.ModelType)
            .Cast<PropertyDescriptor>()
            .Select(prop => prop.Name);
        
        // 找出所有属于子模型的ModelState错误键
        var subModelErrorKeys = bindingContext.ModelState.Keys
            .Where(key => 
                // 排除当前模型直接属性的键（包括带前缀的情况）
                !directPropertyNames.Any(dpn => 
                    key == dpn || key.StartsWith($"{bindingContext.ModelName}.{dpn}."))
            )
            .ToList();
        
        // 移除这些子模型的错误
        foreach (var key in subModelErrorKeys)
        {
            bindingContext.ModelState.Remove(key);
        }
        
        return boundModel;
    }
}

2. 注册自定义Binder #

注册方式有两种，按需选择：

• 全局生效：在Global.asax.cs的Application_Start方法里设置默认Binder：

  protected void Application_Start()
  {
      // ...其他初始化代码
      ModelBinders.Binders.DefaultBinder = new DirectPropertiesOnlyModelBinder();
  }
  

• 特定模型生效：如果只想给某些模型用这个Binder，直接在模型类上标记：

  [ModelBinder(typeof(DirectPropertiesOnlyModelBinder))]
  public class Model2 
  { 
      public int Id; 
      [Required] public string Name; 
      [Required] public Model1 Model1; 
  }
  

轻量替代方案：使用[Bind]属性 #

如果你的场景比较简单，不想写自定义Binder，也可以在Action参数上用[Bind]指定只绑定需要的字段：

public ActionResult Create([Bind(Include = "Id,Name,Model1.Id")] Model2 model)
{
    if (ModelState.IsValid)
    {
        // 执行保存逻辑
        return RedirectToAction("Index");
    }
    return View(model);
}

这种方式的缺点是不够通用，每个需要的Action都得手动写Include列表，但胜在快速简单。

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