ASP.NET Core MVC控制器无法解码表单提交数据问题求助

你遇到的核心问题是表单字段命名不符合ASP.NET Core模型绑定的约定，导致控制器无法将提交数据正确映射到HomeViewModel的嵌套属性和列表集合。以下是具体修复步骤：

1. 核心问题：表单字段命名错误 #

嵌套模型绑定错误 #

HeaderModel的属性需要以Header.为前缀（如Header.DefaultSendNotificationTiming），你当前提交的Header.DaysBeforeBooking层级正确，但缺少必填的Header.DefaultSendNotificationTiming字段，且未正确关联枚举值的选择状态。

列表集合绑定错误 #

List<ListItemModel>的表单字段必须包含索引标识（如ListItems[0].Id），你提交的Id=0、ListItemName=未指定所属的列表项索引，模型绑定无法识别其属于ListItems集合。

2. 正确实现步骤 #

一、使用HtmlHelper生成符合绑定规则的表单元素 #

避免手动编写input标签，利用Html.TextBoxFor、Html.RadioButtonFor等辅助方法自动生成正确的name属性：

@model HomeViewModel

@using (Html.BeginForm("Index", "Home", FormMethod.Post))
{
    @Html.AntiForgeryToken()
    
    <!-- Header部分：绑定嵌套模型属性 -->
    <div>
        <label>默认通知时机:</label>
        @Html.RadioButtonFor(m => m.Header.DefaultSendNotificationTiming, HeaderModel.Options.Immediately) 立即发送
        @Html.RadioButtonFor(m => m.Header.DefaultSendNotificationTiming, HeaderModel.Options.DaysBeforeBooking) 提前指定天数
        @Html.RadioButtonFor(m => m.Header.DefaultSendNotificationTiming, HeaderModel.Options.Name) 指定名称触发
        @Html.ValidationMessageFor(m => m.Header.DefaultSendNotificationTiming)
    </div>

    <div id="daysSection" style="display:none;">
        <label>提前天数:</label>
        @Html.TextBoxFor(m => m.Header.DaysBeforeBooking)
        @Html.ValidationMessageFor(m => m.Header.DaysBeforeBooking)
    </div>

    <div id="nameSection" style="display:none;">
        <label>触发名称:</label>
        @Html.TextBoxFor(m => m.Header.Name)
        @Html.ValidationMessageFor(m => m.Header.Name)
    </div>

    <!-- ListItems部分：绑定列表集合，需带索引 -->
    @for (int i = 0; i < Model.ListItems.Count; i++)
    {
        <div class="list-item-group">
            <input type="hidden" name="ListItems[@i].Id" value="@Model.ListItems[i].Id" />
            <label>列表项名称:</label>
            @Html.TextBoxFor(m => m.ListItems[i].ListItemName)
            @Html.ValidationMessageFor(m => m.ListItems[i].ListItemName)

            <label>覆盖通知时机:</label>
            @Html.RadioButtonFor(m => m.ListItems[i].OverrideTiming, ListItemModel.Override.DaysBeforeBooking) 提前天数
            @Html.RadioButtonFor(m => m.ListItems[i].OverrideTiming, ListItemModel.Override.Name) 指定名称

            <div class="list-days-input" style="display:none;">
                <label>覆盖天数:</label>
                @Html.TextBoxFor(m => m.ListItems[i].ListItemDays)
                @Html.ValidationMessageFor(m => m.ListItems[i].ListItemDays)
            </div>
        </div>
    }

    <input type="submit" value="提交"/>
}

二、初始化ViewModel避免空引用 #

在控制器的GET方法中，必须初始化嵌套对象和列表集合，否则视图无法生成对应表单字段：

public IActionResult Index()
{
    var model = new HomeViewModel
    {
        Header = new HeaderModel(),
        ListItems = new List<ListItemModel>
        {
            new ListItemModel(), // 初始化至少一个列表项
            new ListItemModel()
        }
    };
    return View(model);
}

三、修复jQuery AJAX提交逻辑（若需异步提交） #

如果使用jQuery AJAX提交，需确保序列化表单数据包含正确字段，并携带防伪令牌：

$("form").submit(function (event) {
    event.preventDefault();

    // 自动序列化所有表单字段（包含正确的name属性）
    var formData = $(this).serialize();

    $.ajax({
        url: $(this).attr("action"),
        type: "POST",
        data: formData,
        success: function (res) {
            // 处理成功响应
        },
        error: function (xhr) {
            // 处理错误
        }
    });
});

四、验证模型绑定结果 #

在POST方法中检查ModelState.IsValid，若验证失败返回视图显示错误：

[HttpPost]
public IActionResult Index(HomeViewModel homeItems)
{
    if (!ModelState.IsValid)
    {
        // 重新初始化空列表，避免视图无表单字段
        homeItems.ListItems ??= new List<ListItemModel>();
        if (homeItems.ListItems.Count == 0)
        {
            homeItems.ListItems.Add(new ListItemModel());
        }
        return View(homeItems);
    }

    // 业务逻辑处理
    return RedirectToAction("SubmitSuccess");
}

五、检查自定义验证特性 #

注意RequiredIf不是ASP.NET Core内置特性，需确保你使用的第三方库（如FluentValidation）或自定义实现的RequiredIfAttribute正确继承ValidationAttribute并实现验证逻辑，否则会导致模型绑定失败。

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