ASP.NET Core 6 MVC：提交至控制器的Model为null问题排查

检查ViewModel与表单控件的命名匹配 #

• 确保NewGroupViewModel的所有属性名称（含大小写）和表单中asp-for生成的name属性完全一致。ASP.NET Core模型绑定大小写敏感，比如ViewModel里是Members，表单控件name不能写成members。
• 用浏览器F12查看提交的Form Data，确认每个字段的name和ViewModel属性一一对应。

验证ViewModel的基础配置 #

• 保证NewGroupViewModel是public类，且包含无参构造函数（如果有带参构造函数，必须显式声明无参版本），模型绑定需要实例化ViewModel，无参构造函数是必要条件。
• 检查属性的get/set访问器是否为public，比如public string Members { get; set; }，缺少set会导致无法赋值。

确认表单与控制器的请求方式匹配 #

• 表单的method必须是post，控制器的Create方法要标记[HttpPost]特性，用[HttpGet]会无法接收POST请求的表单数据。
• 若表单无文件上传，不要添加enctype="multipart/form-data"，多余的enctype会干扰模型绑定。

规范[FromForm]特性的使用 #

• 如果控制器参数是[FromForm] NewGroupViewModel model，不要同时使用其他绑定特性（如[FromBody]），多个绑定特性会冲突。
• 对于嵌套ViewModel，比如public SubModel Sub { get; set; }，表单控件需用asp-for="Sub.PropertyName"生成正确的name（格式为Sub.PropertyName）。

调试模型绑定错误 #

• 在控制器方法开头检查ModelState.IsValid，若为false，遍历错误信息定位问题：

  if (!ModelState.IsValid)
  {
      foreach (var error in ModelState.Values.SelectMany(v => v.Errors))
      {
          Console.WriteLine(error.ErrorMessage); // 输出错误到调试窗口
      }
      return View(model);
  }
  

• 启用模型绑定日志，在appsettings.Development.json中添加：

  "Logging": {
      "LogLevel": {
          "Microsoft.AspNetCore.Mvc.ModelBinding": "Debug"
      }
  }
  

  查看调试日志，获取绑定失败的具体原因。

排查表单HTML的有效性 #

• 检查表单中是否有重复的name属性，或未闭合的HTML标签，这类问题会导致浏览器提交的Form Data异常。
• 避免asp-route-*路由参数与ViewModel属性重名，防止绑定冲突。

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