C#如何验证输入参数_C# DataAnnotations模型绑定校验【基础】

先说一个很多开发者都会遇到的困惑：明明给属性贴上了 [Required]，调试时它却像没存在过一样，既不报错也不拦截。问题出在哪儿？其实答案很简单——验证机制根本没有被触发。这不是特性本身失效，而是你压根没给它“上场”的机会。

先说最常见的场景。在 ASP.NET Core 中，[Required] 并不是一个“贴上去就自动生效”的魔法标签。它依赖模型绑定流程，准确地说，是框架在帮你反序列化请求体、表单或查询参数时，顺手执行了验证。如果你跳过这一步，比如手动 new UserDto() 再逐个赋值，那框架根本不知道你在干什么，ModelState.IsValid 永远返回 true。

• 正确的用法：public IActionResult Post([FromBody] UserDto dto)，让框架接管反序列化和校验。
• 错误的做法：手动从 Request.Form 取值赋给新对象，验证器根本没机会读取属性。
• 另外需要注意：如果 DTO 的属性没有 public get，即使你贴了 [Required]，它也会被直接跳过。

为什么 [Required] 对 int 和 DateTime 总是“通过”？

这个坑更隐蔽。因为 int 和 DateTime 是值类型，它们的默认值分别是 0 和 DateTime.MinValue，而 [Required] 只判断“是否为 null”——对于值类型，它永远返回 true。所以哪怕前端传了个空值，后端看到的 int age 也还是 0，验证自然不会拦截。

要解决这个问题，有三种思路：

• 把字段改成可空类型，比如 public int? Age { get; set; }，这样 [Required] 就能判断 null 了。
• 用范围约束代替必填校验，比如 [Range(1, 120)]，这比 [Required] 更贴合业务逻辑。
• 日期字段同理，改成 public DateTime? BirthDate 再配合 [Required]。

还有一点值得注意：前端传 "age": null 时，后端拿到的 int age 仍然是 0。这是 JSON 反序列化的行为，不是验证本身的问题。

非 Controller 层怎么手动验证？

在 Service、Repository 或其他工具类中，你没法依赖 ModelState。这时候得用 Validator.TryValidateObject 主动触发验证。关键是调用时要传对参数：

var context = new ValidationContext(dto);
var results = new List();
bool isValid = Validator.TryValidateObject(dto, context, results, validateAllProperties: true);

• 必须显式传 validateAllProperties: true，否则只校验有值的属性，[Required] 等于没写。
• results 里会包含每个失败项的 ErrorMessage 和 MemberNames，可以用来定位具体字段。
• 这个方法不支持异步和依赖注入。如果你需要查库校验邀请码这种复杂逻辑，建议改用 FluentValidation。

Blazor 中 EditForm 的验证为什么没显示错误？

Blazor 的 DataAnnotationsValidator 只负责计算验证结果，并不会自动弹红字。常见遗漏有两处：

• 必须显式指定 Model 参数，不能只靠 @bind-Value 推断。
• 的 For 必须是表达式树，写成字符串 "Email" 或直接 @model.Email 都无效。
• 嵌套属性要写完整路径，比如 @(() => model.Address.Street)，不能省略中间的 Address。
• ValidationSummary 默认不显示字段级错误，需要加上 ModelErrorsOnly="false"。

最后再确认一下：模型类引用了 System.ComponentModel.DataAnnotations，且属性都是 public 并包含 get。这些条件都满足时，验证才能正常工作。