如何配置ASP.NET Core实现部分有效数据的模型绑定？

给定如下枚举和模型类：

public enum State
{
    Valid = 1,
    Invalid = 2
}

public class Person
{
    public string Name { get; set; }
    
    public State state { get; set; }
}

以及ASP.NET Core控制器动作：

[HttpPost]
public object SavePerson([FromBody] Person person)
{
    return person;
}

当发送合法JSON请求时，模型绑定正常工作：

{
    "name": "John",
    "state": 1
}

但如果将state字段改为无效枚举值（比如"state":""或"state":"1"），person参数会直接变为null——即使请求体里其他字段是有效的，ASP.NET Core也会忽略所有字段。需要配置ASP.NET Core实现只提取请求体中的有效字段，而非直接返回null。

方法1：配置JSON序列化的枚举容错与错误忽略 #

在.NET 6+的Program.cs（或旧版本的Startup.cs）中，修改MVC的JSON序列化配置，开启属性错误忽略并配置枚举的容错处理：

builder.Services.AddControllers()
    .AddJsonOptions(options =>
    {
        // 忽略单个属性的反序列化错误，不影响其他有效属性绑定
        options.JsonSerializerOptions.IgnorePropertiesWithUnknownTypes = true;
        // 允许将字符串形式的数字解析为数值类型
        options.JsonSerializerOptions.NumberHandling = System.Text.Json.Serialization.JsonNumberHandling.AllowReadingFromString;
        
        // 配置枚举容错：遇到无效值时返回默认值，而非抛出异常
        options.JsonSerializerOptions.Converters.Add(new System.Text.Json.Serialization.JsonStringEnumConverter(
            System.Text.Json.Serialization.JsonNamingPolicy.CamelCase,
            allowIntegerValues: true)
        {
            AllowInvalidValues = true
        });
    });

方法2：将枚举改为可空类型 #

如果业务允许state字段为null，直接修改模型中的枚举属性为可空类型：

public class Person
{
    public string Name { get; set; }
    
    public State? state { get; set; } // 改为可空枚举
}

这种情况下，传入无效枚举值时state会被设为null，但Name等有效字段依然能正常绑定。

方法3：自定义枚举转换器 #

如果需要更精细的控制（比如把无效值映射到指定默认枚举项），可以自定义枚举转换器：

public class TolerantEnumConverter<TEnum> : System.Text.Json.Serialization.JsonConverter<TEnum> where TEnum : struct, Enum
{
    public override TEnum Read(ref System.Text.Json.Utf8JsonReader reader, Type typeToConvert, System.Text.Json.JsonSerializerOptions options)
    {
        // 尝试解析字符串形式的枚举
        if (reader.TokenType == System.Text.Json.JsonTokenType.String)
        {
            if (Enum.TryParse<TEnum>(reader.GetString(), out var result))
            {
                return result;
            }
        }
        // 尝试解析数值形式的枚举
        if (reader.TryGetInt32(out var intValue) && Enum.IsDefined(typeof(TEnum), intValue))
        {
            return (TEnum)Enum.ToObject(typeof(TEnum), intValue);
        }
        // 解析失败返回默认值（可根据需求修改为指定枚举项，比如State.Valid）
        return default;
    }

    public override void Write(System.Text.Json.Utf8JsonWriter writer, TEnum value, System.Text.Json.JsonSerializerOptions options)
    {
        writer.WriteStringValue(value.ToString());
    }
}

然后在配置中注册该转换器：

builder.Services.AddControllers()
    .AddJsonOptions(options =>
    {
        options.JsonSerializerOptions.Converters.Add(new TolerantEnumConverter<State>());
    });

方法4：禁用模型绑定的严格校验 #

通过配置ApiBehaviorOptions关闭模型绑定失败时自动返回400的行为，同时手动处理模型状态：

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

之后在控制器中手动校验并保留有效字段：

[HttpPost]
public object SavePerson([FromBody] Person person)
{
    if (!ModelState.IsValid)
    {
        // 提取错误信息，同时返回已绑定的有效字段
        var errors = ModelState.Where(x => x.Value.Errors.Any())
                               .ToDictionary(k => k.Key, v => v.Value.Errors.Select(e => e.ErrorMessage));
        return new { ValidPersonData = person, ValidationErrors = errors };
    }
    return person;
}

这种方式下，即使部分字段绑定失败，person对象依然会被创建，有效字段会被赋值，同时可通过ModelState获取错误详情。

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