Kotlin中Android Room数据库存储嵌套JSON报错问题求助

Room作为关系型数据库ORM框架，默认仅支持映射基础类型、字符串等可直接对应SQL字段类型的数据，当前代码触发报错的核心原因有3个：

• 直接在Ticket实体中声明Category自定义对象类型、List<Content>列表类型字段时，Room无法自动识别类型映射规则，无法生成符合要求的实体构造函数，因此抛出"Entities and POJOs must have a usable public constructor"错误。
• 嵌套对象Category未添加@Embedded注解，Room无法将其内部字段平铺映射为表字段。
• 一对多结构的contents列表不符合Room单字段存储规则，Room不支持直接将列表作为实体字段存储，必须通过关联表或类型转换器实现。

可根据业务需求二选一：

方案1：关联表+@Embedded实现（推荐，符合关系型数据库设计规范） #

该方案支持对嵌套字段做SQL条件查询、排序，适合长期维护的业务场景：

1. 给Category字段添加@Embedded注解，修改Ticket实体，Room会自动将Category内部的id、title字段平铺到tickets表中，添加前缀避免字段命名冲突：

@Entity(tableName = "tickets")
data class Ticket(
    @PrimaryKey val id: Int,
    val title: String,
    val type: String,
    @Embedded(prefix = "category_") val category: Category,
    val status: Int,
    val priority: Int,
    val created_at: String
)

2. 将Content改造为独立Room实体，添加外键关联Ticket主键：

@Entity(
    tableName = "ticket_contents",
    foreignKeys = [
        ForeignKey(
            entity = Ticket::class,
            parentColumns = ["id"],
            childColumns = ["ticket_id"],
            onDelete = ForeignKey.CASCADE
        )
    ]
)
data class Content(
    @PrimaryKey val id: Int,
    @ColumnInfo(name = "ticket_id") val ticketId: Int,
    val username: String,
    val content: String,
    val created_at: String,
    val isOwn: Boolean
)

3. 定义一对多关系映射类，用于查询时返回带内容列表的完整工单数据：

data class TicketWithContents(
    @Embedded val ticket: Ticket,
    @Relation(
        parentColumn = "id",
        entityColumn = "ticket_id"
    )
    val contents: List<Content>
)

后续在DAO层直接定义返回TicketWithContents的查询方法即可，Room会自动完成多表关联查询，不需要手写关联SQL。

方案2：TypeConverter实现（接入简单，适合轻量场景） #

如果不需要对嵌套字段做数据库层面的条件查询，可以通过类型转换器将复杂对象序列化为JSON字符串存储，不需要修改原有实体结构：

1. 编写类型转换类，依赖Gson/Moshi等JSON序列化库完成对象和字符串的转换：

class RoomConverters {
    @TypeConverter
    fun categoryToJson(category: Category): String = Gson().toJson(category)

    @TypeConverter
    fun jsonToCategory(json: String): Category = Gson().fromJson(json, Category::class.java)

    @TypeConverter
    fun contentListToJson(contents: List<Content>): String = Gson().toJson(contents)

    @TypeConverter
    fun jsonToContentList(json: String): List<Content> {
        val listType = object : TypeToken<List<Content>>() {}.type
        return Gson().fromJson(json, listType)
    }
}

2. 在自定义的RoomDatabase类上添加注解，注册转换器：

@Database(entities = [Ticket::class], version = 1)
@TypeConverters(RoomConverters::class)
abstract class AppDatabase : RoomDatabase() {
    // 你的DAO定义
}

注意：该方案下嵌套对象和列表会以整段JSON字符串的形式存储在单字段中，无法通过SQL语句直接筛选、排序嵌套内部的字段，仅适合不需要操作嵌套内部字段的轻量场景。

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