ASP.NET Core表单提交时控制器无法绑定属性如何解决？

核心问题根因 #

你遇到的绑定失败主要由两个问题导致：

1. 表单字段前缀与控制器入参名不匹配：前端asp-for绑定的是RegisterInput.xxx，渲染后表单字段的name属性为RegisterInput.Email/RegisterInput.Password格式，而控制器接收参数的变量名为inputModel，ASP.NET Core默认绑定规则会优先匹配和入参名一致的inputModel.xxx前缀，前缀对不上就会导致绑定失败，这也是你能在Request里拿到提交数据、但自动绑定失效的直接原因。
2. RegisterInputModel类的校验特性都缺失了左方括号，比如Required]应为[Required]，语法错误也会影响模型绑定的校验流程。

排查步骤 #

• 打开浏览器开发者工具的网络面板，提交表单后查看请求的Form Data字段，确认字段前缀是否为RegisterInput.开头
• 在控制器方法开头加断点，查看ModelState.IsValid的值，如果为false，遍历ModelState.Values查看错误信息，可直接定位到字段匹配失败的具体原因
• 检查RegisterInputModel的所有属性特性，确认语法正确，无缺失符号、拼写错误的问题

解决方案 #

三种方案任选其一即可，同时需要修复模型类的语法错误：

方案1：修改前端绑定前缀，和控制器入参名匹配 #

把前端所有asp-for="RegisterInput.xxx"修改为asp-for="inputModel.xxx"，渲染后字段名和控制器入参名一致即可正常绑定：

<!-- 单字段修改示例，其他字段同步修改即可 -->
<div class="form-group">
    <label asp-for="inputModel.Email"></label>
    <input asp-for="inputModel.Email" class="form-control" autofocus />
    <span asp-validation-for="inputModel.Email" class="text-danger"></span>
</div>

方案2：给控制器入参指定绑定前缀 #

无需修改前端代码，直接给入参加[Bind]特性指定匹配的前缀：

[HttpPost]
[ValidateAntiForgeryToken]
public IActionResult RegisterUser([Bind(Prefix = "RegisterInput")] RegisterInputModel inputModel)
{
    _logger.LogInformation($"email: {inputModel.Email}");
    return Redirect("/");
}

方案3：修改控制器入参的变量名 #

直接把入参变量名改成和前端前缀一致的RegisterInput：

[HttpPost]
[ValidateAntiForgeryToken]
public IActionResult RegisterUser(RegisterInputModel RegisterInput)
{
    _logger.LogInformation($"email: {RegisterInput.Email}");
    return Redirect("/");
}

额外修复：修正模型类的特性语法 #

补全所有缺失的左方括号：

public class RegisterInputModel
{
    [Required]
    [EmailAddress]
    [Display(Name = "Email")]
    public string Email { get; set; }

    [Required]
    [StringLength(100, ErrorMessage = "The {0} must be at least {2} and at max {1} characters long.", MinimumLength = 6)]
    [DataType(DataType.Password)]
    public string Password { get; set; }
            
    [DataType(DataType.Password)]
    [Display(Name = "Confirm password")]
    [Compare("Password", ErrorMessage = "The password and confirmation password do not match.")]
    public string ConfirmPassword { get; set; }
}

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