Android Room无法识别@TypeConverters，自定义列表字段存储报错

• 自定义类型转换器的写法不符合KAPT编译流程的识别要求：你在转换器类内部定义了private修饰的reified内联Gson扩展，虽然运行时可以正常完成JSON序列化，但会干扰Room注解处理器对转换器方法的类型映射构建。部分Room版本会因为私有成员的存在，将原本明确的List<Sticker>类型识别为擦除后的原生List类型，和实体类上的字段类型不匹配，最终触发存储方式识别失败的报错。
• 实体类的stickers字段使用了private修饰，配套的getter/setter均为私有访问级别，老版本Room搭配Kotlin编译时会因为无法访问字段的公开访问器，误判该字段缺少对应的类型转换逻辑。
• 自定义Sticker数据类没有提供公共无参构造，导致Room在做类型校验时无法正常解析泛型参数，直接跳过对应转换器的映射注册。

按步骤调整代码即可解决编译报错：

1. 重构类型转换器，消除KAPT识别障碍
   移除类内部的私有内联扩展，将所有@TypeConverter方法移至伴生对象中，添加@JvmStatic注解确保生成的字节码是可被Room直接识别的公共静态方法，同时显式指定TypeToken的泛型类型，避免泛型擦除带来的匹配问题：

   class StickerConverter {
       companion object {
           // 显式定义List<Sticker>的类型标识，不依赖内联泛型
           private val stickerListType = object : TypeToken<List<Sticker>>() {}.type
   
           @TypeConverter
           @JvmStatic
           fun stickersToJson(stickers: List<Sticker>): String {
               return Gson().toJson(stickers)
           }
   
           @TypeConverter
           @JvmStatic
           fun jsonToStickers(json: String): List<Sticker> {
               return Gson().fromJson(json, stickerListType)
           }
       }
   }
   

2. 调整实体类字段修饰符
   去掉stickers字段的private修饰，让Kotlin生成公共的getter/setter，同时移除字段上单独配置的@TypeConverters注解，保留数据库类上的全局转换器配置即可，避免重复配置导致的识别冲突：

   @Entity(tableName = "sticker_packs")
   class StickerPack(
       @PrimaryKey(autoGenerate = true)
       val identifier: Int = 0,
       var name: String,
       var publisher: String,
       var stickers: List<Sticker> = emptyList()
   )
   

3. 补充Sticker类的公共无参构造
   给Sticker数据类的所有构造参数添加默认值，让Kotlin自动生成公共无参构造，避免Room和Gson的类型实例化校验失败：

   data class Sticker(
       val emojis: List<String> = emptyList(),
       var imageDir: String = "",
       var size: Long = 0L
   )
   

4. 检查项目的Room依赖版本，确保使用2.3.0及以上的稳定版本，低版本Room对Kotlin泛型类型转换器的支持存在已知的识别bug。

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