JSON数组解析错误：Cannot deserialize value of type `java.util.ArrayList`

Question

**问题：为什么会出现“Cannot deserialize value of type `java.util.ArrayList`”错误？** 在使用JSON解析库（如Jackson、Gson）时，如果遇到“Cannot deserialize value of type `java.util.ArrayList`”错误，通常是由于JSON结构与目标Java类型不匹配导致的。例如，JSON数据是一个对象 `{}`，但代码期望的是一个数组 `[]`。此外，也可能是因为未正确指定泛型类型，例如将 `List` 解析为 `List`。解决此问题的关键在于检查JSON格式是否符合预期，并确保在代码中正确声明目标类型。如果是Jackson，可以尝试使用 `TypeReference` 或 `ParameterizedTypeReference` 明确指定泛型类型，从而避免解析错误。

Answer 1

1. 初步理解问题

在使用JSON解析库（如Jackson、Gson）时，如果遇到“Cannot deserialize value of type `java.util.ArrayList`”错误，这通常表明JSON数据与目标Java类型不匹配。例如：

• JSON数据是一个对象 `{}`，但代码期望的是一个数组 `[]`。
• JSON数据的结构与Java类的字段定义不一致。
• 未正确指定泛型类型，例如将 `List` 解析为 `List`。

以下是JSON和Java类型不匹配的一个简单示例：

{
  "name": "example"
}
    

如果尝试将其解析为 `ArrayList` 类型，就会出现上述错误。

2. 深入分析问题

为了更深入地理解该问题，我们需要从以下几个方面进行分析：

1. JSON数据的结构是否符合预期？
2. 目标Java类型的声明是否正确？
3. 使用的JSON解析库是否有特定的配置要求？

以Jackson为例，如果JSON数据是对象 `{}`，而目标类型是 `ArrayList`，则会出现解析错误。这是因为`ArrayList`只能解析JSON数组 `[]`。

此外，当涉及泛型类型时，Java的类型擦除机制可能导致解析库无法正确识别类型信息。例如：

ObjectMapper mapper = new ObjectMapper();
List<String> list = mapper.readValue(json, List.class); // 错误
    

这种情况下，需要明确指定泛型类型。

3. 解决方案

针对“Cannot deserialize value of type `java.util.ArrayList`”错误，以下是几种解决方案：

方法	描述
检查JSON格式	确保JSON数据是一个数组 `[]` 而不是对象 `{}`。
使用TypeReference	通过 `TypeReference` 明确指定泛型类型。
使用ParameterizedTypeReference	适用于Spring框架中的HTTP请求解析。

以下是一个使用 `TypeReference` 的示例：

ObjectMapper mapper = new ObjectMapper();
List<String> list = mapper.readValue(json, new TypeReference<List<String>>() {});
    

4. 流程图说明

以下是解决此问题的流程图：

graph TD;
            A[开始] --> B{JSON数据是数组吗？};
            B -- 是 --> C[检查目标类型];
            B -- 否 --> D[修改JSON数据为数组];
            C --> E{目标类型正确吗？};
            E -- 是 --> F[成功解析];
            E -- 否 --> G[使用TypeReference或ParameterizedTypeReference];
            G --> F[成功解析];

流程图展示了如何逐步排查和解决问题。