Android Room含List的POJO存储问题：@Relation方案存在弊端

我之前在开发中也遇到过完全一样的需求——要保存同时包含普通字段和List集合的对象，一开始也是参考官方的UserAndPets示例，用@Embedded和@Relation实现了ShoppingListAndItems类：

class ShoppingListAndItems(
    @Embedded var shoppingList: ShoppingListCache = ShoppingListCache.emptyInstance(),
    @Relation( parentColumn = ShoppingListCache.COLUMN_PARENT_ID, entityColumn = ShoppingItemCache.ENTITY_COLUMN)
    var shoppingItems: List<ShoppingItemCache> = emptyList()
)

但很快就发现这种方案有个核心局限：@Relation注解仅适用于查询场景，不能直接用来插入、更新这个组合对象。因为Room只识别被@Entity注解的实体类，而ShoppingListAndItems只是一个用于映射查询结果的POJO，Room不会自动处理其中的shoppingItems集合，直接插入这个类的实例会报错。

解决思路与实现方案 #

要实现包含List集合对象的完整CRUD，需要拆分操作，分两步处理主实体和关联子实体：

1. 定义支持拆分操作的Dao接口

@Dao
interface ShoppingDao {
    // 插入主实体，返回自增ID（如果你的主实体用了自增主键）
    @Insert
    suspend fun insertShoppingList(shoppingList: ShoppingListCache): Long

    // 批量插入/更新子实体，用REPLACE策略处理冲突
    @Insert(onConflict = OnConflictStrategy.REPLACE)
    suspend fun insertShoppingItems(items: List<ShoppingItemCache>)

    // 查询组合对象必须加@Transaction，保证原子性
    @Transaction
    @Query("SELECT * FROM shopping_lists WHERE id = :listId")
    suspend fun getShoppingListWithItems(listId: Long): ShoppingListAndItems

    // 如果是更新场景，需要先删除旧的子项
    @Query("DELETE FROM shopping_items WHERE parent_id = :listId")
    suspend fun deleteOldItems(listId: Long)
}

2. 保存/更新组合对象的具体逻辑

suspend fun saveShoppingListWithItems(listAndItems: ShoppingListAndItems) {
    val shoppingDao = ... // 获取Dao实例

    // 先插入/更新主实体
    val listId = if (listAndItems.shoppingList.id == 0L) {
        // 新增场景：插入主实体并获取生成的ID
        shoppingDao.insertShoppingList(listAndItems.shoppingList)
    } else {
        // 更新场景：先删除旧的子项，再复用原有ID
        shoppingDao.deleteOldItems(listAndItems.shoppingList.id)
        listAndItems.shoppingList.id
    }

    // 为所有子实体设置关联的主实体ID
    val itemsWithParentId = listAndItems.shoppingItems.map {
        it.copy(parentId = listId) // 确保ShoppingItemCache有对应parentId字段
    }

    // 批量插入子实体
    shoppingDao.insertShoppingItems(itemsWithParentId)
}

关键注意点 #

• 必须用@Transaction标记组合查询方法，避免查询主实体后，子实体数据还没写入导致的结果不一致
• 如果子实体有唯一业务键，也可以不用删除旧数据，直接用REPLACE策略覆盖更新
• 确保parentColumn和entityColumn的字段类型完全匹配，否则会出现关联失败的问题

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