如何根据模型验证结果分别返回400或422状态码？

完全可以实现这个需求，核心思路是自定义验证属性区分错误类型，再手动处理ModelState错误并返回对应状态码，具体步骤如下：

1. 定义自定义验证属性 #

针对格式无效、范围无效两种场景，分别编写自定义验证属性，让它们在验证失败时返回带有明确标识的错误信息：

格式验证属性 #

public class ZipCodeFormatAttribute : ValidationAttribute
{
    // 示例匹配美国邮编格式（5位数字或5-4格式），可根据实际需求调整正则
    private readonly string _formatPattern = @"^\d{5}(-\d{4})?$";

    protected override ValidationResult IsValid(object value, ValidationContext validationContext)
    {
        var zipCode = value as string;
        if (zipCode == null || !Regex.IsMatch(zipCode, _formatPattern))
        {
            return new ValidationResult("Zip Code格式无效", new[] { validationContext.MemberName });
        }
        return ValidationResult.Success;
    }
}

范围验证属性 #

public class ZipCodeRangeAttribute : ValidationAttribute
{
    // 模拟有效邮编集合，实际可从数据库、配置文件读取
    private readonly HashSet<string> _validZipCodes = new HashSet<string> { "10001", "90001", "60601" };

    protected override ValidationResult IsValid(object value, ValidationContext validationContext)
    {
        var zipCode = value as string;
        if (zipCode != null && !_validZipCodes.Contains(zipCode))
        {
            return new ValidationResult("Zip Code不在有效范围内", new[] { validationContext.MemberName });
        }
        return ValidationResult.Success;
    }
}

2. 给模型字段添加验证属性 #

在MyRequest模型的zipCode字段上应用这两个自定义验证：

public class MyRequest
{
    [ZipCodeFormat]
    [ZipCodeRange]
    public string zipCode { get; set; }
}

3. 控制器中手动处理错误状态码 #

先关闭ASP.NET Core默认的自动模型验证响应，再在Action里根据错误类型返回对应状态码：

关闭默认自动验证（Program.cs） #

builder.Services.Configure<ApiBehaviorOptions>(options =>
{
    options.SuppressModelStateInvalidFilter = true;
});

控制器Action逻辑 #

public async Task<IActionResult> ProcessRequest([FromBody] MyRequest request)
{
    if (!ModelState.IsValid)
    {
        // 提取zipCode字段的所有错误信息
        var zipCodeErrors = ModelState["zipCode"]?.Errors.Select(e => e.ErrorMessage);
        if (zipCodeErrors != null)
        {
            // 根据错误信息判断返回状态码
            if (zipCodeErrors.Any(msg => msg.Contains("格式无效")))
            {
                return BadRequest(new { Message = "Zip Code格式无效" }); // 400状态码
            }
            if (zipCodeErrors.Any(msg => msg.Contains("不在有效范围内")))
            {
                return UnprocessableEntity(new { Message = "Zip Code不在有效范围内" }); // 422状态码
            }
        }
        // 其他字段的验证错误统一返回400
        return BadRequest(ModelState);
    }

    // 验证通过后的业务逻辑处理
    return Ok("请求处理成功");
}

补充优化建议 #

• 可以给自定义验证属性添加错误码枚举，替代硬编码的错误信息判断，比如用ValidationResult携带枚举值，后续解析更可靠。
• 有效邮编范围建议从配置文件或数据库读取，避免硬编码在验证属性中，便于后续维护更新。

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