JSON反序列化时Gender2类所有值为null的问题排查

安全阿岳

2026-5-19

嘿，我帮你梳理下Gender2类反序列化后全为null的常见排查点，这些都是实际项目里踩过的坑：

排查Gender2类反序列化全为Null的核心原因

属性名称/大小写不匹配
先检查JSON里的键名和Gender2类的属性名是否完全一致（默认情况下Newtonsoft.Json是区分大小写的）。比如JSON里是"gender_type"，但类里写的是GenderType，就会直接匹配失败。
解决办法：要么统一两边的名称，要么给属性加特性显式绑定JSON键名：
```
public class Gender2
{
    [JsonProperty("gender_type")]
    public string GenderType { get; set; }
}
```
属性访问修饰符不对
一定要确保Gender2类的属性是public的！如果是private或者internal，反序列化器默认无法访问这些属性，自然会赋值为null。
嵌套结构不匹配
检查主类中Gender2属性的名称，和JSON里对应的嵌套结构是否对应。比如主类里定义的是public Gender2 UserGender { get; set; }，那JSON里应该是这样的结构：
```
{
  "UserGender": {
    "GenderType": "Male",
    "OtherGenderProp": "xxx"
  }
}
```
如果JSON里把Gender2的属性直接平级放在主JSON节点下，或者键名和主类中Gender2属性名不一致，都会导致内部属性全null。
缺少无参数构造函数
Newtonsoft.Json默认需要类有无参数的公共构造函数，如果Gender2只有带参数的构造函数，反序列化器无法创建实例，最终会导致属性全为null。解决办法：要么加一个无参构造，要么在带参构造上加上[JsonConstructor]特性。
数据类型不匹配
比如JSON里Gender2的某个属性是数字类型，但类里定义成了字符串，这种类型不兼容的情况也会导致赋值失败为null。仔细核对每个属性的类型和JSON里的类型是否一致，比如JSON是"age": 25，类里不能写成public string Age { get; set; }。