Android Kotlin：无需TypeConverter将含List的实体存入Room数据库

Room默认不支持将List<String>这类集合类型直接作为数据库列存储，不过不用TypeConverter的话，可以通过拆分实体建立一对多关联的方式实现，这是完全可行的方案。具体实现步骤如下：

1. 拆分实体类 #

（1）调整User实体，添加主键 #

Room要求实体必须有主键，因此修改原User类，移除hobbies字段并添加自增主键：

@Entity(tableName = "users")
data class User(
    @PrimaryKey(autoGenerate = true) val id: Long = 0,
    val name: String
)

（2）创建Hobby实体，关联User主键 #

将每个爱好作为独立实体存储，通过外键关联对应的用户：

@Entity(
    tableName = "hobbies",
    foreignKeys = [ForeignKey(
        entity = User::class,
        parentColumns = ["id"],
        childColumns = ["user_id"],
        onDelete = ForeignKey.CASCADE // 用户删除时自动清理关联爱好
    )],
    indices = [Index(value = ["user_id"])] // 给外键列建索引优化查询
)
data class Hobby(
    @PrimaryKey(autoGenerate = true) val hobbyId: Long = 0,
    val hobby: String,
    val userId: Long // 关联目标用户的主键ID
)

2. 创建关联查询的POJO #

为了方便一次性查询用户及其所有爱好，定义一个包含关联关系的POJO：

data class UserWithHobbies(
    @Embedded val user: User,
    @Relation(
        parentColumn = "id",
        entityColumn = "user_id"
    ) val hobbies: List<Hobby>
)

3. 编写DAO接口 #

实现用户、爱好的增删改查，以及关联查询逻辑：

@Dao
interface UserDao {
    // 插入用户，返回生成的主键ID
    @Insert
    suspend fun insertUser(user: User): Long

    // 批量插入爱好
    @Insert
    suspend fun insertHobbies(hobbies: List<Hobby>)

    // 事务查询：获取指定用户及其所有爱好
    @Transaction
    @Query("SELECT * FROM users WHERE id = :userId")
    suspend fun getUserWithHobbies(userId: Long): UserWithHobbies?

    // 事务查询：获取所有用户及其爱好
    @Transaction
    @Query("SELECT * FROM users")
    suspend fun getAllUsersWithHobbies(): List<UserWithHobbies>
}

4. 数据存入流程 #

从Retrofit拿到原始User数据后，分两步完成存储：

// 假设从API获取的原始用户对象
val apiUser: User = ... 

// 1. 插入用户，获取生成的用户ID
val userId = userDao.insertUser(User(name = apiUser.name))

// 2. 转换爱好列表为Hobby实体，关联用户ID后批量插入
val hobbyEntities = apiUser.hobbies.map { Hobby(hobby = it, userId = userId) }
userDao.insertHobbies(hobbyEntities)

补充说明 #

这种方式遵循数据库规范化设计，相比序列化存储集合的方式，优势在于：

• 可以单独查询、修改某个用户的特定爱好
• 避免序列化/反序列化带来的潜在错误
• 数据一致性更强，外键约束能保证用户与爱好的关联关系

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