Kotlin使用Gson解析泛型Api输出时出现类型转换错误的解决方案
出现data字段被解析为Map结构的核心原因,是泛型擦除导致Gson拿不到完整的嵌套泛型类型信息:
- 当你显式指定具体泛型实参
GenericApiOutput<PricePlan>时,TypeToken可以捕获到完整的参数化类型GenericApiOutput(PricePlan),Gson会正确将data字段反序列化为PricePlan对象。 - 当你使用函数自身的动态泛型参数
MyType构造GenericApiOutput<MyType>时,如果类型传递链路中存在泛型擦除,TypeToken捕获到的类型会退化为GenericApiOutput<*>(即泛型实参为Object),Gson无法识别到data字段对应的目标类型,就会默认把JSON对象反序列化为LinkedHashMap,后续强制转换为MyType时就会抛出ClassCastException。
首先排查泛型传递链路的完整性
确保所有涉及泛型传递的工具函数都使用 inline + reified 修饰,不要让泛型实参经过非inline的普通函数传递。你当前的工具函数定义本身符合要求,可以在fromJson方法里打印实际使用的Type信息验证泛型是否丢失:inline fun <reified T> fromJson(json: String?): T { val type = object: TypeToken<T>(){}.type // 如果打印出来的类型里嵌套泛型部分是java.lang.Object,说明泛型信息已经在传递中丢失 println("解析使用的完整类型: $type") return Gson().fromJson<T>(json, type) }常见的丢类型场景包括:调用
requestInterpreter时没有通过inline reified的方式传入明确的MyType,而是经过了多层普通泛型函数转发,导致MyType在运行时被擦除为Object。手动构造完整的参数化类型,避免TypeToken捕获失效
如果遇到TypeToken无法正确捕获嵌套泛型的场景(比如inline函数嵌套带来的类型解析偏差),可以在requestInterpreter内部手动构造包含MyType的完整参数化类型传给Gson:import java.lang.reflect.ParameterizedType inline fun <reified MyType> requestInterpreter(...) { // 手动构造GenericApiOutput<MyType>的完整类型 val genericOutputType = object : ParameterizedType { // 外层类是GenericApiOutput override fun getRawType() = GenericApiOutput::class.java // 泛型实参直接使用MyType的实际运行类 override fun getActualTypeArguments() = arrayOf<Type>(MyType::class.java) override fun getOwnerType() = null } val res = Gson().fromJson<GenericApiOutput<MyType>>(test, genericOutputType) // 此时data会被正确反序列化为MyType实例,而非Map println(res.data) }避免泛型参数命名冲突
你当前代码里requestInterpreter和parseOutput两个函数的泛型参数都命名为MyType,虽然语法上不会直接报错,但在复杂的inline函数嵌套中,可能出现标识符解析偏差,导致TypeToken捕获到错误的类型。建议把工具函数的泛型参数改成通用无冲突的命名:// 修复前的冲突命名 // inline fun <reified MyType> parseOutput(json_response: String): MyType // 修复后的清晰命名 inline fun <reified T> parseOutput(json_response: String): T { return fromJson<T>(json_response) }兜底转换逻辑(不推荐作为常规方案)
如果已经拿到了Map结构的data对象,可以通过Gson把Map重新序列化为JSON,再反序列化为目标MyType类型。这种方式会有额外的序列化开销,只适合作为极端场景的兜底:val output = fromJson<GenericApiOutput<Map<String, Any?>>>(test) val finalData = Gson().fromJson(Gson().toJson(output.data), MyType::class.java) successCallback(finalData)
内容的提问来源于stack exchange,提问作者Nick M

