Kotlin开发Android离线应用如何避免Room预加载JSON生成重复条目

方案1：使用Room自带的预填充功能（推荐） #

Room从2.2.0版本开始原生支持数据库预填充，天然只会在数据库首次创建时执行一次数据导入，无需自行维护初始化状态，也不会出现重复插入问题。
实现步骤：

• 将你的初始JSON文件放在项目src/main/assets目录下
• 构建Room数据库实例时，通过RoomDatabase.Callback的onCreate方法处理数据导入，该回调仅在数据库首次创建时触发：

// 数据库实例构建代码示例
Room.databaseBuilder(
    context.applicationContext,
    AppDatabase::class.java,
    "quote_database" // 自定义数据库名称
)
.addCallback(object : RoomDatabase.Callback() {
    override fun onCreate(db: SupportSQLiteDatabase) {
        super.onCreate(db)
        // 异步执行导入逻辑，避免阻塞主线程
        CoroutineScope(Dispatchers.IO).launch {
            // 读取assets目录下的JSON文件
            val jsonString = context.assets.open("quotes.json")
                .bufferedReader()
                .use { it.readText() }
            // 解析JSON为语录实体类列表
            val quoteList = Gson().fromJson(jsonString, Array<Quote>::class.java).toList()
            // 调用Dao方法批量插入数据
            getInstance(context).quoteDao().insertAll(quoteList)
        }
    }
})
.build()

方案2：自行维护初始化标记（适合复杂自定义场景） #

如果你的初始化逻辑包含JSON导入外的其他操作，可以通过DataStore/SharedPreferences存储初始化状态标记，配合冲突兜底策略实现单次导入：

• 应用启动时先读取初始化标记，标记为false时执行JSON导入，导入完成后将标记改为true
• 插入数据时给Dao方法加冲突忽略策略，就算标记位出现异常也不会生成重复条目
  代码示例：

// 执行逻辑示例，可放在Application或主Activity的onCreate中
lifecycleScope.launch(Dispatchers.IO) {
    val isInitialized = dataStore.data.first()[IS_INITIALIZED] ?: false
    if (!isInitialized) {
        val quoteList = parseQuoteJson()
        // 插入时自动忽略已存在的条目
        quoteDao.insertAllWithIgnore(quoteList)
        // 更新初始化标记
        dataStore.edit { it[IS_INITIALIZED] = true }
    }
}

// Dao层插入方法定义
@Insert(onConflict = OnConflictStrategy.IGNORE)
suspend fun insertAllWithIgnore(quotes: List<Quote>)

执行节点建议 #

• 单Activity架构建议放在Application的onCreate或者主Activity的onCreate中执行，全程异步处理不会阻塞主线程
• 不要在闪屏页主线程执行耗时IO操作，避免启动卡顿

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