大白话剖析Gson解析之`com.google.gson.internal.LikedTreeMap cannot be cast to class`异常

解析 Gson 中的 LikedTreeMap 转换错误

在使用 Gson 解析 JSON 数据时，你可能会遇到 com.google.gson.internal.LikedTreeMap cannot be cast to class 异常。本文将深入探讨这一异常背后的原因，并提供解决方法。

错误分析

该异常表明，在将 Gson 解析的 JSON 数据映射到类对象时发生了类型转换错误。特别是，错误消息指出，系统尝试将 com.google.gson.internal.LikedTreeMap 强制转换为目标类，但由于类型不匹配而失败。

问题的根源

Gson 自动类型转换： 当 Gson 解析包含映射的 JSON 数据时，它会自动将映射转换为 LinkedHashMap 类型（java.util.LinkedHashMap）。

LikedTreeMap 的定义： LikedTreeMap 是一个基于红黑树实现的导航映射，它继承自 AbstractMap<K, V> 类并实现了 NavigableMap<K, V> 接口。

类型转换冲突： 由于 Gson 自动将 JSON 映射转换为 LinkedHashMap，而目标类可能期望不同的映射类型（例如 HashMap），因此就会出现类型转换冲突。

解决方案

有两种方法可以解决此异常：

1. 修改 Gson 默认类型转换器

通过提供自定义类型适配器或使用 GsonBuilder.registerTypeAdapter() 方法，可以修改 Gson 的默认类型转换器，让 Gson 直接将 JSON 映射转换为 HashMap 类型。

示例代码：

Type listType = new TypeToken<Map<String, Object>>() {}.getType();
Gson gson = new GsonBuilder().registerTypeAdapter(listType, new HashMapTypeAdapter()).create();

2. 手动转换 LikedTreeMap

在将 LikedTreeMap 转换为目标类之前，可以手动将其转换为 HashMap。

示例代码：

Type listType = new TypeToken<Map<String, Object>>() {}.getType();
Map<String, Object> map = gson.fromJson(jsonStr, listType);
HashMap<String, Object> hashMap = new HashMap<>(map);

结论

理解 com.google.gson.internal.LikedTreeMap cannot be cast to class 异常背后的原因非常重要，这样才能找到针对性的解决方案。通过修改 Gson 的类型转换器或手动转换 LikedTreeMap，你可以解决此异常并顺利地解析 JSON 数据。

常见问题解答

Q1：为什么 Gson 会自动将 JSON 映射转换为 LinkedHashMap？

A1：LinkedHashMap 保留了插入顺序，而 HashMap 则没有。Gson 默认将 JSON 映射转换为 LinkedHashMap 以便更好地反映 JSON 数据的原始结构。

Q2：如果目标类需要的是 NavigableMap，该如何处理？

A2：可以使用 TreeMap 类型，它实现了 NavigableMap 接口。Gson 也会自动将 JSON 映射转换为 TreeMap。

Q3：是否可以关闭 Gson 的自动类型转换？

A3：是的，可以使用 GsonBuilder.disableInnerClassSupport() 方法来关闭自动类型转换。但是，这可能会导致其他类型的转换错误。

Q4：手动转换 LikedTreeMap 有什么缺点？

A4：手动转换可能会增加代码复杂性和维护成本，特别是当需要处理多个嵌套映射时。

Q5：如何防止此异常再次发生？

A5：了解 Gson 的类型转换机制并仔细设计你的数据模型可以帮助防止此异常再次发生。考虑使用与目标类兼容的映射类型或修改 Gson 的类型转换器以满足你的特定需求。