MVC中Tag Helpers失效：表单提交DTO属性为空且无校验提示

嘿，看来你碰到了ASP.NET Core里模型绑定失败+数据校验不触发的典型坑，我来帮你一步步捋清楚问题所在：

先排查最基础的核心问题 #

1. 确认DTO属性的可访问性与拼写一致性 #

先去检查你的ClientDto类，必须保证三个属性都有公开的getter和setter，而且asp-for指定的名称要和属性名完全匹配（C#大小写敏感，别写错字母）：

public class ClientDto
{
    [Required(ErrorMessage = "公司名称不能为空")]
    public string CompanyName { get; set; } // 这里的属性名要和视图里asp-for="CompanyName"完全对应

    [Required(ErrorMessage = "联系人不能为空")]
    public string ContactPerson { get; set; }

    [Required(ErrorMessage = "联系电话不能为空")]
    public string PhoneNumber { get; set; }
}

要是属性是private set或者压根没写setter，模型绑定根本没法给属性赋值，自然也不会触发[Required]的校验逻辑。

2. 服务器端必须主动校验ModelState #

哪怕客户端校验生效了，服务器端也得在Action里手动检查模型状态，不然空值会直接溜进数据库：

[HttpPost]
public IActionResult AddClient(ClientDto clientDto)
{
    // 关键步骤：先判断模型是否合法
    if (!ModelState.IsValid)
    {
        // 校验失败就返回原视图，错误信息会自动显示在表单对应位置
        return View(clientDto);
    }

    // 确认模型没问题后，再执行存入数据库的逻辑
    _clientRepository.Add(clientDto);
    return RedirectToAction("Index");
}

解决客户端校验不触发的问题 #

如果客户端连错误提示都没弹，大概率是没引入校验必需的脚本。在你的cshtml视图底部（或者布局页里）加上这三个脚本：

<script src="~/lib/jquery/dist/jquery.min.js"></script>
<script src="~/lib/jquery-validation/dist/jquery.validate.min.js"></script>
<script src="~/lib/jquery-validation-unobtrusive/jquery.validate.unobtrusive.min.js"></script>

ASP.NET Core的非侵入式校验完全依赖这三个脚本，缺一个都没法在客户端自动触发[Required]的校验。

检查表单Tag Helper的完整性 #

确保你的表单和输入框Tag Helper写法正确，完整的输入框结构应该是这样的：

<div class="form-group">
    <label asp-for="CompanyName"></label>
    <input asp-for="CompanyName" class="form-control" />
    <!-- 这个span会自动渲染校验错误信息，必须加上 -->
    <span asp-validation-for="CompanyName" class="text-danger"></span>
</div>

别忘了加asp-validation-for标签，不然校验错误没法显示在页面上。另外也要确认asp-controller和asp-action指向的是正确的Action方法。

最后排查隐藏的绑定失败原因 #

要是以上都没问题，但属性还是为空，可以在Action里打印ModelState的错误日志，看看具体绑定失败的原因：

foreach (var error in ModelState.Values.SelectMany(v => v.Errors))
{
    Console.WriteLine($"绑定错误：{error.ErrorMessage}");
}

常见的坑比如属性类型不匹配（比如DTO里是int类型，但表单传了字符串），或者请求参数的name和属性名不一致。

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