ASP.NET Web API 列表模型绑定为空 如何解析setting为List<Setting>？

你遇到的绑定失败本质不是模型绑定流程故障，是数据格式和目标类型不匹配：

• 前端POST传的setting是字符串数组["school"]
• 后端定义的setting是List<Setting>，每个元素是包含hospital、school两个bool属性的对象
• Newtonsoft.Json默认反序列化逻辑没有内置规则把字符串"school"映射为带对应bool值的Setting对象，匹配不上的条目会直接被丢弃，最终列表为空。

不需要使用之前手写JObject解析的方案，也没必要实现完整的自定义模型绑定，通过内嵌的JsonConverter就能解决，改动量极小。

步骤1：编写适配格式的自定义JsonConverter #

这个转换器专门处理Setting类型的反序列化，兼容两种输入格式：

• 传字符串的情况（比如"school"）：自动生成对应属性为true的Setting对象
• 传标准对象的情况（比如{"school":true,"hospital":false}）：走默认反序列化逻辑，不破坏原有正常请求的解析

public class StringToSettingConverter : Newtonsoft.Json.JsonConverter
{
    // 仅对Setting类型生效，避免影响其他类的反序列化流程
    public override bool CanConvert(Type objectType)
    {
        return objectType == typeof(Setting);
    }

    public override object ReadJson(JsonReader reader, Type objectType, object existingValue, JsonSerializer serializer)
    {
        // 处理字符串格式的输入
        if (reader.TokenType == JsonToken.String)
        {
            string enabledKey = reader.Value?.ToString()?.Trim().ToLower();
            return new Setting
            {
                hospital = enabledKey == nameof(Setting.hospital).ToLower(),
                school = enabledKey == nameof(Setting.school).ToLower()
            };
        }

        // 兼容标准对象格式的输入，走原有默认反序列化逻辑
        if (reader.TokenType == JsonToken.StartObject)
        {
            return serializer.Deserialize<Setting>(reader);
        }

        // 其他不识别的格式返回空对象
        return new Setting();
    }

    public override void WriteJson(JsonWriter writer, object value, JsonSerializer serializer)
    {
        // 适配输出的示例逻辑，如果不需要自定义输出可以重写CanWrite返回false，走默认序列化
        var setting = (Setting)value;
        if (setting.school)
        {
            writer.WriteValue(nameof(Setting.school));
        }
        else if (setting.hospital)
        {
            writer.WriteValue(nameof(Setting.hospital));
        }
        else
        {
            writer.WriteNull();
        }
    }
}

如果你仅需要适配输入格式的反序列化逻辑，不需要修改输出的序列化格式，可以在转换器中重写public override bool CanWrite => false;，让序列化完全走原有默认逻辑，避免影响接口的返回结构。

步骤2：挂载转换器到目标类型 #

两种挂载方式二选一即可：

• 直接挂到Setting类上，所有用到Setting类型反序列化的地方自动生效：

  [Newtonsoft.Json.JsonConverter(typeof(StringToSettingConverter))]
  public class Setting
  {
      public bool hospital { get; set; }
      public bool school { get; set; }
  }
  

• 或者只挂到SearchStringDTO的setting属性上，仅针对这个DTO的列表属性生效，不影响其他地方对Setting类的使用：

  public sealed class SearchStringDTO
  {
      public int age { get; set; }
  
      [Newtonsoft.Json.JsonConverter(typeof(StringToSettingConverter))]
      public List<Setting> setting { get; set; }
  }
  

改完之后不需要修改控制器代码，默认的模型绑定流程会自动调用挂载的转换器：

• 当请求体传{age:202, setting:["school"]}时，会自动把"school"转成new Setting{ school=true, hospital=false }，最终绑定结果和你预期的格式完全一致。

ASP.NET Web API 处理POST请求体的JSON参数时，核心流程是走JsonMediaTypeFormatter基于Newtonsoft.Json的反序列化逻辑，不是传统的查询串/表单的模型绑定流程。

• 写完整的自定义模型绑定需要绕开默认的JSON处理流程，还要手动处理请求流的读取、缓存等逻辑，维护成本很高。
• 用自定义JsonConverter是直接嵌入现有反序列化管道的，没有额外的请求流读取、性能损耗，也不需要手写大量JObject、JToken的遍历解析逻辑。

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