使用 Gson 和 Kotlin 泛型将数据转换为自定义类

本文旨在解决在使用 Kotlin 和 Gson 库时，将 JSON 数据反序列化为自定义类，特别是涉及到泛型和 reified 类型参数时可能遇到的问题。核心问题在于类型擦除会导致 Gson 无法正确识别目标类型，从而产生 ClassCastException。本文将深入探讨问题的原因，并提供多种解决方案，帮助开发者避免此类错误，确保数据反序列化的正确性。

问题分析

在使用 Gson 将 JSON 数据反序列化为 Kotlin 类时，如果涉及到泛型，特别是与 reified 关键字一起使用时，可能会遇到 ClassCastException。 这种异常通常表明 Gson 无法将 JSON 数据正确地映射到目标类。

例如，以下代码片段展示了可能出现问题的场景：

object RemoteClient {    inline fun  call(request: Request, defValue: T? = null): T? {        try {            val data = PlatformProxy.call(request.data)            println(data)            return XPLPC.config.serializer.decodeFunctionReturnValue(data)        } catch (e: Exception) {            Log.e(                Constants.LOG_GROUP,                "[RemoteClient : call] Error when try to decode return value: ${e.message}"            )        }        return defValue    }    inline fun  callAsync(request: Request, defValue: T? = null): Deferred {        return CoroutineScope(Dispatchers.IO).async {            return@async call(request, defValue)        }    }}interface JsonSerializer {    fun  decodeFunctionReturnValue(data: String): T?}class GsonJsonSerializer: JsonSerializer {    override fun  decodeFunctionReturnValue(data: String): T? {        try {            val type = object : TypeToken<JsonFunctionReturnValueData>() {}.type            val gson = createGson()            return gson.fromJson<JsonFunctionReturnValueData>(data, type).r        } catch (e: Exception) {            Log.e(                Constants.LOG_GROUP,                "[JsonSerializer : decodeFunctionReturnValue] Error when parse json: ${e.message}"            )        }        return null    }    private fun createGson(): Gson {        return GsonBuilder().create()    }}data class JsonFunctionReturnValueData(val r: T)

上述代码中，decodeFunctionReturnValue 函数尝试使用 Gson 将 JSON 字符串 data 反序列化为 JsonFunctionReturnValueData 类型。问题在于，即使 call 函数中的类型参数 T 被标记为 reified，但在 decodeFunctionReturnValue 函数中，T 并不是 reified 的。这意味着在运行时，TypeToken 实际上创建的是 TypeToken<JsonFunctionReturnValueData