com.google.gson.internal.LinkedTreeMap cannot be cast to java.lang.String

### 解决 `LinkedTreeMap` 无法转换为 `String`

当使用 Gson 进行 JSON 反序列化时，如果目标对象是一个自定义类而非标准集合类型，则可能会遇到 `ClassCastException`。具体来说，在尝试将 `com.google.gson.internal.LinkedTreeMap` 转换为其他类型（如 `java.lang.String` 或者任何特定业务实体类）时会抛出此异常。

为了防止这种错误发生，可以采取以下几种方法之一：

#### 方法一：确保正确指定泛型参数

在调用 `fromJson()` 函数之前，应该通过 `TypeToken` 明确指出期望的结果类型。这有助于让 Gson 知道如何构建最终的对象实例而不是默认创建 `LinkedTreeMap` 实例来表示未知类型的映射关系[^3]。

// 定义具体的返回类型
Type typeOfT = new TypeToken<String>(){}.getType();
String resultStr = gson.fromJson(jsonInput, typeOfT);

#### 方法二：处理原始 Map 数据再转为目标类型

另一种方式是从 JSON 中先解析得到一个通用的 `Map<String,Object>` 对象，然后再根据实际情况将其进一步加工成为所需的字符串或其他形式的数据结构[^1]。

JsonElement jsonElement = JsonParser.parseString(jsonInput);
if (jsonElement.isJsonObject()) {
    JsonObject jsonObject = jsonElement.getAsJsonObject();
    Set<Map.Entry<String, JsonElement>> entries = jsonObject.entrySet();
    
    StringBuilder sb = new StringBuilder();
    for (Map.Entry<String, JsonElement> entry : entries) {
        sb.append(entry.getKey()).append(": ").append(entry.getValue().getAsString()).append("\n");
    }
    String formattedResult = sb.toString();
}

#### 方法三：编写自定义反序列化器

对于更复杂的需求，还可以考虑实现自己的 `JsonDeserializer<T>` 接口来自定义反序列化的逻辑流程，从而更好地控制从 JSON 到 Java 对象之间的转换过程[^2]。

public class CustomDeserializer implements JsonDeserializer<String> {

    @Override
    public String deserialize(JsonElement json, Type typeOfT,
                              JsonDeserializationContext context)
            throws JsonParseException {
        
        // 自定义转换逻辑...
        return json.getAsString(); 
    }
}

GsonBuilder builder = new GsonBuilder();
builder.registerTypeAdapter(String.class, new CustomDeserializer());
Gson customGson = builder.create();

customGson.fromJson(jsonInput, String.class);