ASP.NET Core中的模型验证是什么？如何实现？

来源：这里教程网时间：2026-02-21 17:24:59 作者：

ASP.NET Core中的模型验证，简单来说，就是确保你从客户端（比如浏览器）接收到的数据符合你预期的格式和规则。这对于保证数据的完整性、安全性和应用程序的稳定运行至关重要。实现方式多种多样，但核心都是围绕着数据注解（Data Annotations）和自定义验证展开的。

解决方案：

ASP.NET Core提供了强大的模型验证机制，主要通过以下几个步骤实现：

数据注解（Data Annotations）： 这是最常用的方式。你可以在你的模型类（通常是ViewModel或DTO）的属性上添加各种注解，例如
[Required]
、
[StringLength]
、
[Range]
、
[EmailAddress]
等。这些注解定义了属性必须满足的规则。
public class UserViewModel { [Required(ErrorMessage = "用户名是必填项")] [StringLength(50, MinimumLength = 3, ErrorMessage = "用户名长度必须在3到50个字符之间")] public string Username { get; set; } [Required(ErrorMessage = "密码是必填项")] [DataType(DataType.Password)] public string Password { get; set; } [EmailAddress(ErrorMessage = "无效的邮箱地址")] public string Email { get; set; } [Range(18, 120, ErrorMessage = "年龄必须在18到120之间")] public int Age { get; set; } }

在Controller中使用
ModelState.IsValid
进行验证： 当你的Controller接收到模型数据时，你需要检查
ModelState.IsValid
属性。如果该属性为
false
，则表示模型验证失败，你需要将错误信息返回给客户端。
[HttpPost] public IActionResult Create(UserViewModel model) { if (!ModelState.IsValid) { // 模型验证失败，将错误信息返回给客户端 return View(model); // 或者返回BadRequest，根据你的API设计 } // 模型验证成功，执行后续操作（例如保存到数据库） // ... return RedirectToAction("Index"); }

自定义验证属性： 如果数据注解无法满足你的需求，你可以创建自定义的验证属性。这需要你继承
ValidationAttribute
类，并重写
IsValid
方法。
public class CustomValidationAttribute : ValidationAttribute { protected override ValidationResult IsValid(object value, ValidationContext validationContext) { if (value == null) { return new ValidationResult("值不能为空"); } string strValue = value.ToString(); if (strValue.Contains("forbiddenWord")) { return new ValidationResult("值包含禁用词"); } return ValidationResult.Success; } } public class MyModel { [CustomValidation] public string MyProperty { get; set; } }

IValidatableObject
接口： 模型类也可以实现
IValidatableObject
接口，该接口包含一个
Validate
方法，你可以在该方法中执行更复杂的验证逻辑，例如跨属性验证。
public class Product : IValidatableObject { public decimal Price { get; set; } public decimal Discount { get; set; } public IEnumerable<ValidationResult> Validate(ValidationContext validationContext) { if (Discount > Price) { yield return new ValidationResult("折扣不能大于价格", new[] { "Discount", "Price" }); } } }

客户端验证： ASP.NET Core 默认支持客户端验证，这意味着验证规则会在客户端（通常是浏览器）执行，从而减少服务器的负载。客户端验证依赖于jQuery Validate插件。

为什么我的模型验证总是失败？

模型验证失败的原因有很多，最常见的是：

必填字段为空： 使用了
[Required]
注解的字段没有提供值。 数据类型不匹配： 例如，你期望一个整数，但客户端发送的是字符串。 超出范围： 使用了
[Range]
注解的字段的值超出了指定的范围。 字符串长度不符合要求： 使用了
[StringLength]
注解的字段的长度不符合要求。 邮箱地址格式不正确： 使用了
[EmailAddress]
注解的字段不是有效的邮箱地址。 自定义验证失败： 你的自定义验证属性返回了错误。 客户端验证未启用或配置错误： 客户端验证依赖于一些javascript库，如果这些库没有正确引入或者配置，客户端验证将不会生效。

为了诊断问题，你可以：

在
ModelState.IsValid
为
false
时，遍历
ModelState.Values
，查看每个属性的错误信息。 使用浏览器的开发者工具查看客户端发送的数据是否正确。 调试你的自定义验证属性，确保其逻辑正确。

如何在API中使用模型验证？

在API中使用模型验证与在MVC应用程序中使用模型验证类似，但返回结果的方式略有不同。通常，API会返回一个包含错误信息的JSON响应，而不是一个View。

[ApiController]
[Route("api/[controller]")]
public class UsersController : ControllerBase
{
    [HttpPost]
    public IActionResult Create([FromBody] UserViewModel model)
    {
        if (!ModelState.IsValid)
        {
            return BadRequest(ModelState); // 返回400 Bad Request，包含错误信息
        }
        // ...
        return CreatedAtAction(nameof(Get), new { id = 1 }, model); // 返回201 Created
    }
    [HttpGet("{id}")]
    public IActionResult Get(int id)
    {
        return Ok(new { Id = id, Name = "Test" });
    }
}

在这个例子中，如果模型验证失败，

BadRequest(ModelState)

会返回一个400 Bad Request响应，响应体包含一个JSON对象，其中包含了所有验证错误信息。客户端可以解析这个JSON对象，并将错误信息显示给用户。

[FromBody]

特性告诉 ASP.NET Core 从请求正文中读取数据并将其绑定到

UserViewModel

模型。

如何禁用客户端验证？

虽然客户端验证可以提高用户体验，但在某些情况下，你可能需要禁用它。例如，你可能需要使用自定义的客户端验证逻辑，或者你可能不希望在客户端暴露验证规则。

你可以通过以下方式禁用客户端验证：

在
_ViewStart.cshtml
中禁用：你可以设置
ViewData["ValidateAntiForgeryToken"] = false;
来禁用整个应用程序的客户端验证。 在特定的View中禁用： 你可以在特定的View中设置
ViewData["ValidateAntiForgeryToken"] = false;
来禁用该View的客户端验证。 在Controller Action中禁用： 你可以在Controller Action中使用
[IgnoreAntiforgeryToken]
特性来禁用该Action的客户端验证。

需要注意的是，禁用客户端验证会增加服务器的负载，因为所有验证都需要在服务器端执行。另外，

ValidateAntiForgeryToken

用于防止跨站点请求伪造（CSRF）攻击。禁用它通常是不推荐的，除非你有其他的CSRF保护机制。

如何进行远程验证？

远程验证允许你使用服务器端的代码来验证客户端输入。这对于需要访问数据库或其他外部资源的验证非常有用。例如，你可以使用远程验证来检查用户名是否已存在。

创建Controller Action： 你需要创建一个Controller Action来执行验证逻辑。该Action应该返回一个JSON对象，其中包含一个布尔值，表示验证是否成功。
[AcceptVerbs("Get", "Post")] public IActionResult VerifyUsername(string username) { if (_userService.IsUsernameAvailable(username)) { return Json(true); // 用户名可用 } else { return Json($"用户名 {username} 已经被使用"); // 用户名不可用 } }

使用
[Remote]
注解： 在你的模型类的属性上使用
[Remote]
注解，指定用于执行验证的Controller Action。
public class UserViewModel { [Remote(action: "VerifyUsername", controller: "Users")] [Required(ErrorMessage = "用户名是必填项")] public string Username { get; set; } }