构建含关联对象列表的Room实体时数据库存储报错，求解决方案

出现这个错误是因为Room默认不支持直接将自定义对象列表（比如List<Parts>）存入数据库，SQLite作为关系型数据库，可通过以下两种方式处理：

方案一：使用一对多关联（推荐，符合数据库设计规范） #

Maintenance和Parts是明显的一对多关系，正确的做法是在Parts实体中添加外键关联Maintenance的ID，而非在Maintenance中存储Parts列表。

1. 修改Parts实体，添加外键字段：

@Parcelize
@Entity(foreignKeys = [ForeignKey(
    entity = Maintenance::class,
    parentColumns = ["id"],
    childColumns = ["maintenanceId"],
    onDelete = ForeignKey.CASCADE // 可选，删除Maintenance时自动删除关联的Parts
)])
data class Parts (
    @PrimaryKey(autoGenerate = true)
    val id: Int,
    var serialNumber: Long,
    var description: String,
    var model: String,
    var maintenanceId: Int // 关联对应的Maintenance主键ID
) : Parcelable

2. 创建组合数据类，用于关联查询Maintenance和对应的Parts列表：

data class MaintenanceWithParts(
    @Embedded val maintenance: Maintenance,
    @Relation(
        parentColumn = "id",
        entityColumn = "maintenanceId"
    )
    val parts: List<Parts>
)

3. 在Dao中通过事务查询关联数据：

@Dao
interface MaintenanceDao {
    @Transaction
    @Query("SELECT * FROM Maintenance")
    suspend fun getMaintenanceWithParts(): List<MaintenanceWithParts>
}

方案二：添加类型转换器（快速实现，适合简单场景） #

通过将List<Parts>序列化为JSON字符串存储，读取时再反序列化为列表。

1. 引入JSON序列化库（比如Gson），在项目依赖中添加对应配置。

2. 创建类型转换器类：

class Converters {
    private val gson = Gson()

    @TypeConverter
    fun partsListToJson(parts: List<Parts>): String {
        return gson.toJson(parts)
    }

    @TypeConverter
    fun jsonToPartsList(json: String): List<Parts> {
        val type = object : TypeToken<List<Parts>>() {}.type
        return gson.fromJson(json, type)
    }
}

3. 在RoomDatabase类中注册转换器：

@Database(entities = [Maintenance::class, Parts::class], version = 1)
@TypeConverters(Converters::class)
abstract class AppDatabase : RoomDatabase() {
    abstract fun maintenanceDao(): MaintenanceDao
    abstract fun partsDao(): PartsDao
}

两种方案对比 #

• 一对多关联：数据结构清晰，支持单独操作Parts（修改、查询单个部件），符合关系型数据库设计，适合复杂业务场景。
• 类型转换器：实现简单快速，但无法单独操作列表中的单个Parts，查询性能较差，数据耦合度高，仅适合小型、简单的数据存储需求。

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