如何使用JSON.NET验证类型不确定的JSON响应是否为数组？

我经常碰到这种接口返回类型不固定的场景，用JSON.NET确实会遇到你说的这个问题，给你梳理几个靠谱的解决思路，帮你避开不必要的异常：

方案一：先判断JSON类型再解析（推荐） #

这种方法不需要依赖try/catch，先把响应解析成通用的JToken，再判断它的类型是数组还是对象，针对性地反序列化。既避免了异常捕获的性能开销，代码逻辑也更清晰：

// 假设你已经拿到了响应的JSON字符串
string jsonResponse = await httpClient.GetStringAsync("your-api-url");

// 先解析成JToken，这一步能处理任何合法的JSON格式
JToken rootToken = JToken.Parse(jsonResponse);

if (rootToken.Type == JTokenType.Array)
{
    // 反序列化为数组/列表
    List<YourItemModel> arrayResult = rootToken.ToObject<List<YourItemModel>>();
    // 处理数组逻辑
}
else if (rootToken.Type == JTokenType.Object)
{
    // 反序列化为对象
    YourObjectModel objectResult = rootToken.ToObject<YourObjectModel>();
    // 处理对象逻辑
}
else
{
    // 处理其他特殊情况，比如返回null、纯字符串等
    throw new InvalidOperationException("Unexpected JSON type received");
}

方案二：用try/catch捕获解析异常（适合特定场景） #

如果你的接口绝大多数情况下返回数组，只有极少数场景返回对象，用try/catch也是可以的，代码会更简洁。但要注意只捕获特定的序列化异常，不要捕获所有异常：

List<YourItemModel> arrayResult = null;
YourObjectModel objectResult = null;
string jsonResponse = await httpClient.GetStringAsync("your-api-url");

try
{
    // 先尝试解析为数组
    arrayResult = JsonConvert.DeserializeObject<List<YourItemModel>>(jsonResponse);
}
catch (JsonSerializationException ex)
{
    // 数组解析失败，再尝试解析为对象
    objectResult = JsonConvert.DeserializeObject<YourObjectModel>(jsonResponse);
}

if (arrayResult != null)
{
    // 处理数组逻辑
}
else if (objectResult != null)
{
    // 处理对象逻辑
}

关于Schema验证的疑问 #

你提到的为对象创建另一个Schema，其实不太必要——因为Schema本身是针对特定类型的，你还是需要先判断JSON的类型，才能决定用哪个Schema去验证。反而不如直接用JToken先判断类型的方式更直接高效。

通用异常处理 #

不管用哪种解析方式，都可能遇到网络错误或无效JSON格式的情况，所以外层最好套一个全局的try/catch来处理这些通用错误：

try
{
    string jsonResponse = await httpClient.GetStringAsync("your-api-url");
    // 这里放上面的解析逻辑
}
catch (HttpRequestException ex)
{
    // 处理网络请求失败的情况，比如超时、连接中断等
    Console.WriteLine($"Request failed: {ex.Message}");
}
catch (JsonReaderException ex)
{
    // 处理JSON格式无效的情况
    Console.WriteLine($"Invalid JSON: {ex.Message}");
}

总结 #

• 优先选方案一，逻辑清晰，避免不必要的异常捕获，性能更好；
• 如果接口返回数组的占比极高，可以用方案二简化代码；
• 不要依赖Schema来区分类型，直接判断JToken的类型更高效。

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