ASP.NET Core中ModelState部分属性ValidationState为Unvalidated问题排查

问题场景 #

我有一个控制器的POST方法接收MyModel模型，方法内包含如下检查逻辑：

[HttpPost("mymodel")]
public async Task<IActionResult> DoStuff(MyModel model)
{
   if (!ModelState.IsValid)
   {
     // 提前返回错误信息
   }

   // ...
}

当传入特定数据时，ModelState.IsValid == false且ModelState.ErrorCount == 0。导致模型无效的原因是部分属性的ValidationState == Unvalidated，使整个模型处于未验证状态。这些未验证的属性有的带有验证特性，有的没有；而验证状态正常的属性也存在同样的特性有无情况。

排查步骤 #

• 检查模型绑定完成情况：
  这类问题大多源于部分属性未成功绑定，导致验证流程未触发。调试时可打印Unvalidated属性的原始值，确认是否未被赋值：

  foreach (var entry in ModelState)
  {
      if (entry.Value.ValidationState == ModelValidationState.Unvalidated)
      {
          Console.WriteLine($"属性: {entry.Key}, 原始值: {entry.Value.RawValue}");
      }
  }
  

• 核对请求数据与属性的匹配性：
  确认POST数据格式（JSON/表单等）与MyModel属性是否匹配：比如属性名大小写是否兼容（默认JSON绑定大小写不敏感，但自定义规则可能例外）、嵌套对象结构是否正确、数组/集合类数据格式是否合法。
• 排查自定义绑定/转换逻辑：
  如果MyModel或特定属性使用了自定义模型绑定器、类型转换器，可能在绑定阶段中断，导致属性未进入验证流程。可暂时移除自定义逻辑，测试是否恢复正常。
• 检查全局验证配置与过滤器：
  查看是否存在自定义IValidatableObject实现、全局验证过滤器，或是在Startup/Program.cs中修改了默认验证规则，导致部分属性被跳过验证。
• 确认属性访问权限：
  确保MyModel中Unvalidated属性为公共可读写（public get; set;），只读属性或私有setter会导致模型绑定无法赋值，进而跳过验证。
• 分析特定数据的特殊性：
  对比触发问题的特定数据与正常数据的差异：比如是否包含特殊字符、空值、超出范围的数值，或是某些属性缺失，导致绑定器无法处理。

为什么是Unvalidated而非验证错误？ #

ModelValidationState.Unvalidated表示属性从未进入验证流程，而非验证失败。常见原因：

1. 模型绑定器无法将请求数据映射到该属性，属性未被赋值，验证系统直接跳过其验证步骤。
2. 自定义绑定逻辑中手动标记属性为Unvalidated，或绑定过程提前退出，未触发验证。
3. 全局配置禁用了部分属性的自动验证（若未使用[ValidateNever]特性可排除此情况）。

验证错误（ModelValidationState.Invalid）是属性绑定成功但未满足验证规则（比如[Required]属性为空）；而Unvalidated是绑定未完成，验证根本未执行。

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