注册Gson类型适配器时遇java.util.List警告的问题排查

你遇到的问题核心是Kotlin集合与Java集合在Gson类型系统中的映射差异，以及编译器警告和Gson类型匹配的冲突，以下是具体解决思路和方案：

问题原因 #

Kotlin的List接口编译后会直接映射到java.util.List，但Kotlin编译器会提示优先使用Kotlin标准库的集合类型。而Gson底层基于Java的类型系统，只有当注册时的TypeToken指向Java的List类型时，才能和适配器的类型正确匹配。

解决方案 #

方案1：用注解抑制警告，同时保留正确的类型注册

直接在注册时指定java.util.List，并用Kotlin注解消除编译器警告：

@Suppress("UNCHECKED_CAST")
GsonBuilder().registerTypeAdapter(
    object : TypeToken<java.util.List<MyObject>>() {}.type,
    MyObjectsTypeAdapter()
)

或者针对泛型参数使用@JvmSuppressWildcards，避免Kotlin自动生成通配符导致的匹配问题：

GsonBuilder().registerTypeAdapter(
    object : TypeToken<List<@JvmSuppressWildcards MyObject>>() {}.type,
    MyObjectsTypeAdapter()
)

方案2：使用Gson的TypeToken.getParameterized构建类型

这种方式更简洁，能避免匿名内部类带来的警告，同时明确指定类型参数：

val listType = TypeToken.getParameterized(List::class.java, MyObject::class.java).type
GsonBuilder().registerTypeAdapter(listType, MyObjectsTypeAdapter())

这里的List::class.java本质就是java.util.List的Class对象，既符合Kotlin编码习惯，又能让Gson正确识别类型。

补充说明 #

你在适配器中使用kotlin.collections.List完全没问题，因为运行时它和java.util.List是同一个类型，Gson匹配时只会检查运行时类型，只要注册时的TypeToken类型正确，适配器就能正常工作。

内容的提问来源于stack exchange，提问作者lostintranslation