为何ModelState对非字符串类型属性不返回错误信息？

这个问题我之前在ASP.NET MVC/Core项目里也碰到过，核心原因通常和ModelState的键名匹配、错误收集逻辑，以及值类型的模型绑定特性有关，下面给你逐一拆解：

1. 检查ModelState.AddModelError的键名是否完全匹配 #

当你手动添加错误时，第一个参数的键名必须和ViewModel中属性的名称严格一致（虽然ASP.NET Core的模型绑定不区分大小写，但ModelState的错误键是区分的）。比如你的ViewModel属性是AreaCode，就不能写成"areaCode"或者"ViewModel.AreaCode"（除非是嵌套属性）。

正确的写法示例：

// 假设你的ViewModel是这样的
public class UserViewModel
{
    public int AreaCode { get; set; }
    public string Username { get; set; }
}

// 控制器中手动添加错误
[HttpPost]
public IActionResult Submit(UserViewModel vm)
{
    if (vm.AreaCode <= 0)
    {
        // 键名必须和属性名完全一致
        ModelState.AddModelError("AreaCode", "区号必须是大于0的有效整数");
    }
    // ...其他逻辑
    if (!ModelState.IsValid)
    {
        return BadRequest(FormatErrorResponse(ModelState));
    }
}

2. 验证FormatErrorResponse是否正确遍历所有错误 #

很多时候问题出在错误收集的静态方法上，比如有些实现会过滤值类型属性，或者只取第一个错误但没处理空消息的情况。

推荐你用这个更健壮的实现：

public static Dictionary<string, string> FormatErrorResponse(ModelStateDictionary modelState)
{
    var errorDict = new Dictionary<string, string>();
    foreach (var keyValuePair in modelState)
    {
        var errorMessages = keyValuePair.Value.Errors
            .Where(e => !string.IsNullOrEmpty(e.ErrorMessage))
            .Select(e => e.ErrorMessage);
        
        if (errorMessages.Any())
        {
            errorDict[keyValuePair.Key] = string.Join("; ", errorMessages);
        }
    }
    return errorDict;
}

这个实现会遍历所有ModelState项，过滤掉空的错误消息，把同一个属性的多个错误合并成字符串，避免遗漏。

3. 非可空值类型的模型绑定特性坑点 #

对于int这类非可空值类型，如果你没有给它传值，模型绑定器会自动设置为默认值0，此时ModelState.IsValid会是true（除非你加了Range这类验证属性）。但如果你手动添加了错误，理论上应该会被包含在ModelState中——不过要确保你是在模型绑定完成后才添加错误（也就是在Action方法内部，参数已经绑定到ViewModel之后），如果是在过滤器之类的提前阶段添加，可能不会生效。

如果你的属性允许为空，建议改成可空值类型int?，再配合[Required]属性，这样模型绑定器会自动处理空值的错误，同时你手动添加的错误也能正常被捕获：

public class UserViewModel
{
    [Required(ErrorMessage = "请填写区号")]
    public int? AreaCode { get; set; }
}

4. 排查是否有其他代码清除了ModelState错误 #

最后检查一下项目中有没有自定义过滤器、模型绑定器或者其他逻辑，在你调用FormatErrorResponse之前清空了ModelState。比如有些团队会写全局过滤器重置ModelState，这会导致你手动添加的错误被丢失。

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