ASP.NET Core MVC模型无法传递至后续页面的问题解决

常见问题排查及修复步骤 #

1. 补全表单的模型绑定字段 #

如果只在表单里放提交按钮，之前页面的模型数据不会自动传递。必须把需要保留的模型属性以隐藏字段的形式加入表单，确保提交时能把完整模型数据发回控制器：

<form asp-action="SendData" method="post">
    <!-- 显示概览页的内容 -->
    <p>姓名: @Model.Username</p>
    <p>手机号: @Model.PhoneNumber</p>
    
    <!-- 隐藏字段传递所有需要保留的模型属性 -->
    <input type="hidden" asp-for="Username" />
    <input type="hidden" asp-for="PhoneNumber" />
    <input type="hidden" asp-for="Age" />
    
    <button type="submit">进入数据发送页</button>
</form>

要是模型有嵌套复杂属性，得给每个子属性单独加隐藏字段，比如@Html.HiddenFor(m => m.Address.Street)。

2. 检查控制器Action的绑定逻辑 #

确保SendData的POST Action正确接收模型，同时先排查模型绑定是否失败：

[HttpPost]
public IActionResult SendData(UserInfoModel model)
{
    // 先看模型状态是否有效，绑定失败会在这里暴露问题
    if (!ModelState.IsValid)
    {
        // 可以打印错误信息排查，比如输出到控制台
        var errorMessages = ModelState.Values.SelectMany(v => v.Errors.Select(e => e.ErrorMessage));
        foreach (var msg in errorMessages)
        {
            Console.WriteLine(msg);
        }
        return View(model);
    }
    
    // 后续业务逻辑
    return View(model);
}

另外要保证模型类和它的属性都是public的，不然绑定机制无法读取属性值。

3. 用TempData临时存储模型 #

如果表单里加一堆隐藏字段太麻烦，可以用TempData在Action之间临时存模型（需要模型支持序列化）：

• 在概览页的POST Action里存模型：

[HttpPost]
public IActionResult Overview(UserInfoModel model)
{
    if (ModelState.IsValid)
    {
        // 序列化后存到TempData
        TempData["UserModel"] = JsonSerializer.Serialize(model);
        return RedirectToAction("SendData");
    }
    return View(model);
}

• 在SendData的GET Action里读取：

public IActionResult SendData()
{
    if (TempData.ContainsKey("UserModel"))
    {
        var modelJson = TempData["UserModel"].ToString();
        var model = JsonSerializer.Deserialize<UserInfoModel>(modelJson);
        return View(model);
    }
    // 没有模型数据就返回上一页
    return RedirectToAction("Overview");
}

注意：用TempData需要先在Program.cs里配置Session支持，添加builder.Services.AddSession();和app.UseSession();。

4. 避免用RedirectToAction直接传模型 #

如果之前的页面跳转用了RedirectToAction，直接把模型当参数传会丢失数据——因为Redirect是GET请求，没法携带复杂模型。这种情况必须用TempData/Session存，或者只拼接简单参数（不适合复杂模型）。

额外排查技巧 #

打开浏览器开发者工具的Network标签，查看提交表单时的Form Data，确认所有需要的模型字段都被正确提交了。如果有字段缺失，要么是没加隐藏字段，要么是字段名称和模型属性不匹配。

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