如何让插入Room数据库的数据持久化？预填充库数据丢失问题

你遇到的核心问题是：向预填充的Room数据库插入的数据，在应用重启、重装或导出数据库后消失。以下是针对性的排查点和解决方案：

1. 检查实体类的主键配置 #

确保WordEntity的主键开启自增特性，否则传入ID=0时无法生成有效主键，导致数据无法持久化：

@Entity(tableName = "words")
data class WordEntity(
    @PrimaryKey(autoGenerate = true) // 必须添加此注解
    val id: Int,
    val cantoneseWord: String,
    val englishWord: String,
    val isActive: Boolean
)

2. 修正DAO的插入方法 #

确保addWord注解的冲突策略符合需求，避免因主键冲突导致插入失败：

@Dao
interface WordDao {
    // 若主键重复则忽略，避免覆盖现有数据
    @Insert(onConflict = OnConflictStrategy.IGNORE)
    suspend fun addWord(word: WordEntity)
}

3. 调整协程中的UI操作 #

setupWordRecyclerView属于UI操作，不能在Dispatchers.IO线程执行，需移到主线程：

dialogBinding.btnYes.setOnClickListener {
    val cantoneseWord = dialogBinding.etAddCantoneseWord.text.toString()
    val englishWord = dialogBinding.etAddEnglishWord.text.toString()
    when {
        cantoneseWord.isNullOrEmpty() -> {
            Toast.makeText(this, "Please enter a Cantonese word/phrase", Toast.LENGTH_SHORT).show()
        }
        englishWord.isNullOrEmpty() -> {
            Toast.makeText(this, "Please enter a English word/phrase", Toast.LENGTH_SHORT).show()
        }
        else -> {
            val newWord = WordEntity(0, cantoneseWord, englishWord, true)
            lifecycleScope.launch {
                // IO线程执行数据库操作
                withContext(Dispatchers.IO) {
                    wordDao.addWord(newWord)
                }
                // 主线程更新UI
                setupWordRecyclerView(wordDao)
                Toast.makeText(this@SearchActivity, "Successfully added", Toast.LENGTH_SHORT).show()
                wordDialog.dismiss()
            }
        }
    }
}

4. 优化数据库初始化逻辑 #

移除不必要的fallbackToDestructiveMigration()，除非你明确需要在版本不匹配时销毁数据库（该操作会清空所有数据）：

fun getInstance(context: Context): WordDatabase {
    synchronized(this) {
        var instance = INSTANCE
        if (instance == null) {
            instance = Room.databaseBuilder(
                context.applicationContext,
                WordDatabase::class.java,
                "CantoWords"
            )
            // 仅在数据库不存在时从资产复制
            .createFromAsset("database/CantoWords_shortened.db")
            .build()
            INSTANCE = instance
        }
        return instance
    }
}

5. 验证数据写入状态 #

通过Android Studio的Device File Explorer导出数据库文件（路径：data/data/你的包名/databases/CantoWords），用DB Browser for SQLite查看：

• 如果导出后能看到插入的数据，说明数据已持久化，重启后消失可能是数据库实例或查询逻辑问题；
• 如果导出后看不到数据，说明插入操作未成功，需重新检查实体类和DAO配置。

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