使用HTTPWebRequest处理JSON：反序列化返回null、序列化后值为null求排查

我来帮你一步步排查这两个问题，咱们从最常见的原因入手：

1. 先确认实体类和JSON字段是否匹配 #

这是反序列化返回null最常见的原因！你提供的JSON结构很明确，对应的C#实体类必须和JSON的字段名、类型完全对应（或者通过特性映射）。

比如直接匹配JSON小写命名的实体类：

public class ServerResponse
{
    public bool status { get; set; }
    public string hostname { get; set; }
    public int port { get; set; }
    public string protocol { get; set; }
    public int ping { get; set; }
    public Players players { get; set; }
    public bool cached { get; set; }
}

public class Players
{
    public int online { get; set; }
    public int max { get; set; }
}

如果你习惯用C#的PascalCase（首字母大写）命名，记得用JsonProperty特性做映射（以Newtonsoft.Json为例）：

using Newtonsoft.Json;

public class ServerResponse
{
    [JsonProperty("status")]
    public bool Status { get; set; }
    [JsonProperty("hostname")]
    public string Hostname { get; set; }
    [JsonProperty("port")]
    public int Port { get; set; }
    [JsonProperty("protocol")]
    public string Protocol { get; set; }
    [JsonProperty("ping")]
    public int Ping { get; set; }
    [JsonProperty("players")]
    public Players Players { get; set; }
    [JsonProperty("cached")]
    public bool Cached { get; set; }
}

public class Players
{
    [JsonProperty("online")]
    public int Online { get; set; }
    [JsonProperty("max")]
    public int Max { get; set; }
}

要是字段名没对应上，反序列化器根本找不到要赋值的属性，自然返回null。

2. 检查流读取是否完整 #

你的代码片段里StreamReader的部分没写完，一定要确保把响应流的内容全部读取出来，不然JSON不完整也会导致反序列化失败：

var request = (HttpWebRequest)WebRequest.Create("https://use.gameapis.net/mc/query/players/139.99.32.82");
request.Method = "GET";

using (var response = (HttpWebResponse)request.GetResponse())
using (var stream = response.GetResponseStream())
using (var reader = new StreamReader(stream))
{
    // 读取完整的JSON字符串
    string jsonContent = reader.ReadToEnd();
    // 反序列化
    ServerResponse serverData = JsonConvert.DeserializeObject<ServerResponse>(jsonContent);
}

这里用using语句是为了自动释放资源，避免流被提前关闭导致读取不完整。

3. 解决“反序列化可用但序列化后变null”的问题 #

这个情况几乎都是属性访问权限或者序列化器配置的问题：

• 先检查实体类的属性有没有公共的get和set方法：如果属性只有get没有set，或者是私有/保护的，序列化器读不到属性值，就会输出null。
• 如果你用的是.NET Core+的System.Text.Json，默认要求属性有公共setter，或者可以配置序列化器允许访问私有成员：

  var serializeOptions = new JsonSerializerOptions
  {
      PropertyNameCaseInsensitive = true,
      IncludeFields = true // 如果用字段而不是属性的话
  };
  string serializedJson = JsonSerializer.Serialize(serverData, serializeOptions);
  

• 要是用Newtonsoft.Json，检查有没有误设NullValueHandling.Ignore（不过如果整个对象变null，还是优先看属性访问权限）。

4. 实用调试技巧 #

• 先把读取到的jsonContent打印出来，确认和你提供的JSON完全一致，排除网络请求返回异常的情况。
• 反序列化时捕获异常，能直接定位问题：

  try
  {
      ServerResponse serverData = JsonConvert.DeserializeObject<ServerResponse>(jsonContent);
  }
  catch (JsonException ex)
  {
      // 打印异常信息，比如哪个字段类型不匹配、缺少映射
      Console.WriteLine($"反序列化出错：{ex.Message}");
  }
  

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