如何在ROOM中始终插入数据至首行并确保仅存一条记录？

核心思路是给实体类添加一个固定值的主键，利用主键唯一性约束让数据库始终只存在一条记录，再通过REPLACE策略直接覆盖原有数据，无需提前清空表。

1. 修改实体类，添加固定主键 #

给ListResponse添加值固定为1的主键字段，确保表中仅能存在一条记录：

@Entity
data class ListResponse(
    @PrimaryKey val id: Int = 1, // 固定主键，始终为1，利用唯一性约束限制单条数据
    @SerializedName("json")
    @ColumnInfo(name = "json_column")
    val answer: ResponseJson
)

2. 优化Dao层操作 #

方案A：基于@Insert的替换操作 #

直接插入带固定主键的实体，REPLACE策略会自动覆盖原有id=1的记录：

@Insert(onConflict = OnConflictStrategy.REPLACE)
suspend fun insert(list: ListResponse): Long

调用时只需构造ListResponse(answer = newJson)即可，id默认取1。

方案B：直接用@Query执行替换（更简洁） #

无需构造实体对象，通过SQL语句直接完成替换逻辑：

const val TABLE_NAME = "ListResponse"

@Query("REPLACE INTO $TABLE_NAME (id, json_column) VALUES (1, :json)")
suspend fun upsert(json: ResponseJson)

3. 数据库迁移（若已上线） #

如果数据库已有用户在使用，需添加迁移逻辑兼容旧数据：

val MIGRATION_OLD_TO_NEW = object : Migration(旧版本号, 新版本号) {
    override fun migrate(database: SupportSQLiteDatabase) {
        // 新增id列，默认值设为1
        database.execSQL("ALTER TABLE $TABLE_NAME ADD COLUMN id INTEGER DEFAULT 1")
        // 确保现有记录的id统一为1
        database.execSQL("UPDATE $TABLE_NAME SET id = 1")
        // 设置id为主键
        database.execSQL("ALTER TABLE $TABLE_NAME ADD PRIMARY KEY (id)")
    }
}

构建Room数据库时添加该迁移：

Room.databaseBuilder(context, AppDatabase::class.java, "app_db")
    .addMigrations(MIGRATION_OLD_TO_NEW)
    .build()

方案优势 #

• 避免DELETE+INSERT两次IO操作，性能更优
• 逻辑简洁，依赖主键唯一性约束确保单条数据，无需额外判断
• 操作原子性更强，REPLACE是单条SQL操作，不会出现数据中间状态

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