Room数据库预填充失败：表已创建但数据未插入

针对你遇到的Room数据库表创建成功但JSON数据未插入的问题，可从以下几个核心点逐一排查：

1. 确保数据库操作在后台线程执行 #

Room默认禁止主线程进行数据库读写操作，若预填充逻辑在主线程执行，会直接触发异常（可能被忽略），导致数据插入失败。

修正示例（用协程IO调度器）：

// 预填充函数
suspend fun populateDatabase(context: Context) {
    val taskDao = AppDatabase.getInstance(context.applicationContext).taskDao()
    val jsonArray = loadJsonArrayFromAssets(context)
    val tasks = parseJsonToTaskEntities(jsonArray)
    taskDao.insertAll(tasks)
}

// 调用时切换到IO线程
lifecycleScope.launch(Dispatchers.IO) {
    populateDatabase(requireContext())
}

2. 检查Dao插入方法的正确性 #

确保插入方法使用@Insert注解，并设置冲突策略，同时通过返回值验证插入结果：

Dao层正确实现：

@Dao
interface TaskDao {
    // 插入失败时返回-1，可通过返回值排查问题
    @Insert(onConflict = OnConflictStrategy.REPLACE)
    suspend fun insertAll(tasks: List<Task>): List<Long>
}

调用时可打印返回结果，确认是否有插入失败的情况：

val insertResults = taskDao.insertAll(tasks)
val failedCount = insertResults.count { it == -1L }
if (failedCount > 0) {
    Log.e("Prepopulate", "Failed to insert $failedCount tasks")
}

3. 验证JSON解析逻辑是否正确 #

JSON字段与实体类字段不匹配、类型转换错误，会导致解析出的实体列表为空，自然没有数据插入。

注意事项：

• 实体类需用@ColumnInfo明确指定列名，确保与JSON的key完全对应
• 解析时严格匹配数据类型（比如JSON的int不能转成实体类的String）

解析示例：

data class Task(
    @PrimaryKey val id: Int,
    @ColumnInfo(name = "task_title") val title: String,
    @ColumnInfo(name = "task_desc") val description: String
)

fun parseJsonToTaskEntities(jsonArray: JSONArray): List<Task> {
    val tasks = mutableListOf<Task>()
    for (i in 0 until jsonArray.length()) {
        val jsonObj = jsonArray.getJSONObject(i)
        tasks.add(
            Task(
                id = jsonObj.getInt("id"),
                title = jsonObj.getString("task_title"),
                description = jsonObj.getString("task_desc")
            )
        )
    }
    return tasks
}

4. 保证数据库实例是单例 #

若每次获取TaskDao时都创建新的RoomDatabase实例，会导致操作的不是同一个数据库文件，数据自然无法持久化。

数据库单例实现：

@Database(entities = [Task::class], version = 1)
abstract class AppDatabase : RoomDatabase() {
    abstract fun taskDao(): TaskDao

    companion object {
        @Volatile
        private var INSTANCE: AppDatabase? = null

        fun getInstance(context: Context): AppDatabase {
            return INSTANCE ?: synchronized(this) {
                val instance = Room.databaseBuilder(
                    context.applicationContext,
                    AppDatabase::class.java,
                    "task_db"
                ).build()
                INSTANCE = instance
                instance
            }
        }
    }
}

5. 正确触发预填充时机 #

建议在数据库创建完成后自动触发预填充，避免时机过早导致数据库未初始化完成：

Room.databaseBuilder(
    context.applicationContext,
    AppDatabase::class.java,
    "task_db"
).addCallback(object : RoomDatabase.Callback() {
    override fun onCreate(db: SupportSQLiteDatabase) {
        super.onCreate(db)
        // 数据库创建后执行预填充
        GlobalScope.launch(Dispatchers.IO) {
            populateDatabase(context.applicationContext)
        }
    }
}).build()

最后：添加异常捕获与日志 #

在预填充逻辑中加入异常捕获，定位具体错误：

suspend fun populateDatabase(context: Context) {
    try {
        val jsonArray = loadJsonArrayFromAssets(context)
        val tasks = parseJsonToTaskEntities(jsonArray)
        if (tasks.isEmpty()) {
            Log.e("Prepopulate", "No tasks parsed from JSON")
            return
        }
        val insertResults = AppDatabase.getInstance(context).taskDao().insertAll(tasks)
        Log.d("Prepopulate", "Successfully inserted ${insertResults.size - insertResults.count { it == -1L }} tasks")
    } catch (e: Exception) {
        Log.e("Prepopulate", "Error during prepopulation", e)
    }
}

内容的提问来源于stack exchange，提问作者Bayu Tantra Bramandhita