使用Android Kotlin操作Room数据库遇唯一约束失败错误求解决

这个错误的核心是你尝试插入或更新的数据中，favorite表的id主键值已存在，以下是具体解决办法：

1. 修正主键生成逻辑 #

如果id是自增主键，检查实体类定义是否正确，避免手动赋值覆盖自增逻辑：

@Entity(tableName = "favorite")
data class Favorite(
    @PrimaryKey(autoGenerate = true) val id: Int = 0,
    // 其他字段
)

插入新数据时，不要手动给id传值，让Room自动生成唯一主键。如果是业务自定义主键，确保每次插入的id都是全局唯一的。

2. 用冲突策略处理重复主键 #

如果业务允许覆盖已有同主键的数据，在DAO的插入方法上添加冲突替换策略：

@Dao
interface FavoriteDao {
    @Insert(onConflict = OnConflictStrategy.REPLACE)
    suspend fun insertFavorite(favorite: Favorite)
}

这样当主键重复时，Room会自动删除旧数据并插入新数据，不会抛出约束异常。

3. 先查询再决定操作 #

如果需要保留旧数据，避免覆盖，先查询目标id是否存在，再执行插入或更新：

suspend fun addOrUpdateFavorite(favorite: Favorite) {
    val existing = favoriteDao.getFavoriteById(favorite.id)
    if (existing == null) {
        favoriteDao.insertFavorite(favorite)
    } else {
        favoriteDao.updateFavorite(favorite)
    }
}

对应的DAO需补充查询和更新方法：

@Dao
interface FavoriteDao {
    @Query("SELECT * FROM favorite WHERE id = :id")
    suspend fun getFavoriteById(id: Int): Favorite?

    @Update
    suspend fun updateFavorite(favorite: Favorite)
}

4. 过滤外部数据的重复id #

如果数据来自服务器或其他外部源，先对数据列表做去重处理，确保流入数据库的id没有重复。比如用distinctBy { it.id }过滤重复项：

val uniqueFavorites = remoteFavorites.distinctBy { it.id }
favoriteDao.insertAll(uniqueFavorites)

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