LinkedTreeMap cannot be cast to class XXX问题解决

问题信息

Exception in thread "main" java.lang.ClassCastException: class com.google.gson.internal.LinkedTreeMap cannot be cast to class 
com.xxx.xxx.xxx (com.google.gson.internal.LinkedTreeMap and 
com.xxx.xxx.xxx are in unnamed module of loader 'app')
at com.xxx.xxx.xxx(XXXClass.java:12)

问题原因

这个异常表面是类型转换错误，但是实际原因是Gson转List时Item类型没转换对，常见于对Gson自行封装的通用json转List时，因为Gson转List时必须指定List的Item类型，如果无法识别就会自动将Item转成LinkedTreeMap。

解决方法

解决方法也很简单，通用的Gson转List用下面这个代码即可：

/**
 * 将JSON字符串转换为特定类型的List。
 *
 * @param json      JSON字符串
 * @param itemType  列表中项的类型
 * @param <T>       列表中项的类型
 * @return          转换后的List
 */
public static <T> List<T> fromJsonToList(String json, Class<T> itemType) {
    List<T> resultList = new ArrayList<>();

    // 将JSON字符串转换为JsonElement
    JsonElement jsonElement = gson.fromJson(json, JsonElement.class);
    if (!jsonElement.isJsonArray()) {
        throw new JsonParseException("JSON is not a JSON array");
    }

    // 将JsonElement转换为JsonArray
    JsonArray jsonArray = jsonElement.getAsJsonArray();

    // 遍历JsonArray，将每个元素转换为指定类型
    for (JsonElement element : jsonArray) {
        T item = gson.fromJson(element, itemType);
        resultList.add(item);
    }

    return resultList;
}