ASP.NET Core JSON反序列化部分字段未填充问题排查

• 大小写匹配问题
  默认情况下，System.Text.Json的反序列化是区分大小写的。如果clients.json里字段是蛇形命名（比如client_name）或者小写驼峰（比如clientname），但模型属性是大驼峰（比如ClientName），即使去掉[JsonPropertyName]，也会匹配失败。可以在反序列化时配置忽略大小写：

  var options = new JsonSerializerOptions
  {
      PropertyNameCaseInsensitive = true
  };
  var clients = JsonSerializer.Deserialize<List<Client>>(jsonContent, options);
  

• 字段类型不兼容
  检查模型属性的类型和JSON中对应字段的类型是否完全一致。比如JSON里是字符串类型的数字（"age": "30"），但模型里是int Age；或者JSON里是null但模型属性是值类型且没设可为空（比如int而不是int?），都会导致字段无法填充。

• 嵌套对象/数组反序列化失败
  如果Client模型包含嵌套的对象或数组属性，比如Address Address，要确保嵌套模型的结构和JSON中的嵌套结构完全匹配，包括字段名、类型，否则整个嵌套对象会被设为null，看起来像是父模型的字段没填充。

• JSON结构与模型层级不匹配
  比如你的JSON是外层有一个根对象包裹（比如{"clients": [/* 数组内容 */]}），但你直接反序列化为List<Client>，而不是对应的根模型（比如public class ClientRoot { public List<Client> Clients { get; set; } }），这会导致所有数据都无法正确映射。

• 全局反序列化配置冲突
  检查Program.cs中是否配置了全局JsonSerializer选项，比如强制蛇形命名策略，而你的JSON字段不符合该规则：

  builder.Services.AddControllers()
      .AddJsonOptions(options =>
      {
          options.JsonSerializerOptions.PropertyNamingPolicy = JsonNamingPolicy.SnakeCaseLower;
      });
  

  这种全局配置会覆盖局部反序列化的默认行为，导致字段匹配失败。

• 属性访问权限问题
  确保Client和BaseModel中需要填充的属性是public的，并且同时具备get和set方法。私有或内部属性默认无法被System.Text.Json访问填充。

• JSON格式合法性问题
  先验证clients.json的语法是否正确，比如字段名是否加引号、逗号是否缺失、转义字符是否错误等。部分格式错误可能导致反序列化程序静默跳过字段，而非抛出异常。

• 继承模型的属性映射问题
  因为Client继承自BaseModel，要确认父类BaseModel中的属性也符合字段名匹配、类型兼容、访问权限正常这些要求，父类属性的问题也会导致整体反序列化异常。

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