Room数据库基于Year+Week组合列实现存在即忽略的插入

实现步骤 #

1. 在Dao中添加存在性查询方法 #

首先在你的WeekDao中新增查询方法，用于检查数据库是否已存在指定year和week组合的记录：

@Dao
interface WeekDao {
    // 原有插入方法（可保留，也可移除OnConflictStrategy.IGNORE，因为我们会提前判断）
    @Insert
    suspend fun initInsertWeek(week: Week)

    // 新增存在性查询：返回true表示已存在对应记录
    @Query("SELECT EXISTS(SELECT 1 FROM Weeks WHERE year = :year AND week = :week)")
    suspend fun isWeekExists(year: Int, week: Int): Boolean
}

2. 在业务逻辑层实现条件插入逻辑 #

在Repository或ViewModel中，先执行查询判断记录是否存在，仅当记录不存在时执行插入操作：

class WeekRepository(private val weekDao: WeekDao) {
    suspend fun insertWeekIfNotExists(week: Week) {
        val recordExists = weekDao.isWeekExists(week.year, week.week)
        if (!recordExists) {
            weekDao.initInsertWeek(week)
        }
    }
}

注意事项 #

• 这种先查询再插入的方式在单协程/单线程环境下可以稳定运行，但如果是多线程并发插入相同year+week组合的场景，可能出现竞态条件（两个线程同时查询到记录不存在，进而都执行插入）。
• 如果需要处理并发场景，更可靠的方案是给year和week添加唯一索引，配合你原本的@Insert(onConflict = OnConflictStrategy.IGNORE)：
  在实体类的@Entity注解中添加唯一索引：

  @Entity(
      tableName = "Weeks",
      indices = [Index(value = ["year", "week"], unique = true)]
  )
  data class Week(...)
  

  此时Room会自动拦截重复的year+week组合插入请求，无需手动查询判断。

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