JsonConvert.DeserializeObject后AuthToken对象为空问题求助

1. 核对属性名与JSON字段的匹配度 #

反序列化空对象最常见的原因是类属性名和JSON字段名大小写、拼写不一致——比如API返回蛇形命名的access_token，你的类用驼峰的AccessToken却没做映射。

• 解决：给属性加序列化特性做映射，示例如下：

// Newtonsoft.Json 写法
public class AuthToken
{
    [JsonProperty("access_token")]
    public string AccessToken { get; set; }
    
    [JsonProperty("expires_in")]
    public int ExpiresIn { get; set; }
}

// System.Text.Json 写法
public class AuthToken
{
    [JsonPropertyName("access_token")]
    public string AccessToken { get; set; }
    
    [JsonPropertyName("expires_in")]
    public int ExpiresIn { get; set; }
}

2. 调整反序列化器的配置 #

不同序列化库默认规则不同：

• 用System.Text.Json时，默认区分大小写，如果API返回小写字段，必须开启忽略大小写配置：

var options = new JsonSerializerOptions
{
    PropertyNameCaseInsensitive = true
};
var authToken = JsonSerializer.Deserialize<AuthToken>(responseString, options);

• 用Newtonsoft.Json的话，默认不区分大小写，但如果手动开启了严格匹配，记得改回来。

3. 检查JSON响应的结构是否匹配类 #

很多API返回的JSON是嵌套结构，比如：

{ "data": { "access_token": "xxx", "expires_in": 3600 } }
如果你的AuthToken类直接对应内层字段，没有外层的data容器，自然会反序列化成空。

• 解决：要么调整类结构适配嵌套，要么先解析到中间对象再取内层数据：

public class ApiResponse
{
    public AuthToken Data { get; set; }
}

public class AuthToken
{
    public string AccessToken { get; set; }
    public int ExpiresIn { get; set; }
}

// 反序列化时
var apiResponse = JsonSerializer.Deserialize<ApiResponse>(responseString);
var authToken = apiResponse.Data;

4. 确认响应字符串完整无异常 #

别光信Postman，在代码里把读取到的responseString打印出来，和Postman的响应对比——有时候会出现编码错误、响应截断的情况，导致JSON格式不完整。

var responseString = await response.Content.ReadAsStringAsync();
Console.WriteLine(responseString); // 打印出来逐字符对比

5. 检查类属性的访问权限 #

确保AuthToken的属性是public，并且有get和set方法——反序列化器无法访问私有/内部属性，或者只有get没有set的属性，自然赋值失败。
错误示例：

public class AuthToken
{
    // 无set方法，反序列化无法赋值
    public string AccessToken { get; } 
    // 私有属性，无法被访问
    private int ExpiresIn { get; set; }
}

正确示例：

public class AuthToken
{
    public string AccessToken { get; set; }
    public int ExpiresIn { get; set; }
}

6. 捕获反序列化异常 #

很多时候反序列化会抛出异常但被忽略，加个try-catch块看具体错误，能快速定位问题：

try
{
    var authToken = JsonSerializer.Deserialize<AuthToken>(responseString);
}
catch (JsonException ex)
{
    Console.WriteLine($"反序列化错误：{ex.Message}");
}

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