ASP.NET Core 6 MVC视图模型绑定失败问题求助

1. 检查视图模型属性的可访问性 #

确保AirplaneViewModel中需要绑定的属性都是公共且包含getter和setter的，模型绑定仅能访问公共可写属性。示例：

// 错误写法：无setter或属性为私有
public string PlaneModel { get; }

// 正确写法
public string PlaneModel { get; set; }

2. 验证表单字段与模型属性名的一致性 #

脚手架生成的视图通常会自动匹配字段名，但手动修改后可能出现偏差。检查视图中input标签的name属性是否和模型属性名完全一致（区分大小写），推荐使用asp-for标签助手自动生成正确字段名，避免拼写错误：

<!-- 对应模型的PlaneModel属性 -->
<input asp-for="PlaneModel" class="form-control" />

3. 确认控制器Action的参数特性 #

表单提交场景下，不要给视图模型参数添加错误的特性标记，比如[FromRoute]或[FromQuery]。ASP.NET Core MVC默认会自动识别表单提交，若存在绑定冲突可显式添加[FromForm]：

[HttpPost]
public IActionResult Create([FromForm] AirplaneViewModel model)
{
    // 业务逻辑
}

4. 处理复杂类型嵌套属性 #

如果AirplaneViewModel包含嵌套的复杂类型属性，需确保视图字段名称采用点标记法（如ParentProp.ChildProp）。脚手架生成的视图会自动处理该场景，若手动调整过视图，需确认格式正确：

<!-- 对应模型Engine子属性的MaxSpeed字段 -->
<input asp-for="Engine.MaxSpeed" class="form-control" />

5. 查看模型绑定错误详情 #

在控制器Action中通过ModelState.IsValid判断绑定状态，若失败可遍历ModelState获取具体错误信息，定位绑定失败的属性：

[HttpPost]
public IActionResult Create(AirplaneViewModel model)
{
    if (!ModelState.IsValid)
    {
        // 输出错误信息到控制台或日志
        foreach (var state in ModelState.Values)
        {
            foreach (var error in state.Errors)
            {
                Console.WriteLine(error.ErrorMessage);
            }
        }
        return View(model);
    }
    // 后续业务逻辑
}

6. 确认表单提交配置正确 #

确保视图中的表单使用POST方法，且enctype符合需求（无文件上传时默认application/x-www-form-urlencoded即可，脚手架生成的表单会默认配置正确）：

<form asp-action="Create" method="post">
    <!-- 表单内容 -->
</form>

内容的提问来源于stack exchange，提问作者dr.Xis