ASP.NET Core MVC HttpPost方法中Model参数值为空的问题

核心问题 #

POST方法中Employee emp参数为null，主要源于两个关键问题：

1. 表单未提交DepartmentId字段：Employee的DepartmentId是关联部门的核心标识，但表单未包含该字段的输入项；同时Department.DepartmentName是禁用状态（禁用字段不会被浏览器提交），导致模型绑定缺少必要关联信息，触发绑定失败。
2. 缺少防伪造令牌对应字段：控制器方法标记了[AutoValidateAntiforgeryToken]，但表单未生成对应的防伪造令牌字段，可能引发请求拦截或模型绑定异常。

具体修复步骤 #

1. 修改表单代码 #

替换原有部门相关表单区域，添加DepartmentId隐藏字段，将禁用的输入改为纯文本展示（避免提交无效字段）：

@model Employee

<form method="post">
    @* 添加防伪造令牌，匹配控制器的验证特性 *@
    @Html.AntiForgeryToken()

    <div>
        <label asp-for="FirstName" class="form-label"></label>
        <input asp-for="FirstName" class="form-control"/>
    </div>

    <div>
        <label asp-for="LastName" class="form-label"></label>
        <input asp-for="LastName" class="form-control" />
    </div>

    <div>
        <label asp-for="Age" class="form-label"></label>
        <input asp-for="Age" class="form-control" />
    </div>

    <div>
        <label class="form-label">Department</label>
        @* 仅展示部门名称，不提交 *@
        <span class="form-control-plaintext">@Model.Department.DepartmentName</span>
        @* 添加隐藏字段提交DepartmentId *@
        <input asp-for="DepartmentId" type="hidden" />
    </div>

    <div>
        <label asp-for="Salary" class="form-label"></label>
        <input asp-for="Salary" class="form-control" />
    </div>

    <br />
    <button type="submit" class="btn btn-primary">Add employee</button>
    <a asp-action="ListDepartments">Cancel</a>
</form>

2. 优化控制器逻辑 #

在POST方法中添加DepartmentId有效性验证，同时处理验证失败时的部门信息回显：

[HttpPost]
[AutoValidateAntiforgeryToken]
public IActionResult AddEmployee(Employee emp)
{
    // 验证DepartmentId是否存在于数据库
    if (!dbContext.Departments.Any(d => d.Id == emp.DepartmentId))
    {
        ModelState.AddModelError(nameof(emp.DepartmentId), "无效的部门ID");
    }

    if (ModelState.IsValid)
    {
        // 无需手动设置Department实体，EF Core会通过DepartmentId自动关联
        dbContext.Add(emp);
        dbContext.SaveChanges();
        return RedirectToAction("ListDepartments");
    }

    // 验证失败时，重新加载Department实体用于页面回显
    emp.Department = dbContext.Departments.Find(emp.DepartmentId);
    return View(emp);
}

3. 额外注意事项 #

• 禁用属性（disabled）的表单元素不会被浏览器提交，不要用它传递需要保存的字段值。
• 创建关联实体时，只需提交外键（如DepartmentId）即可，无需提交整个关联对象，EF Core会通过外键自动完成关联。

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