Jetpack Compose首次运行时Room预填充数据无法通过LiveData/Flow返回

问题描述 #

在Jetpack Compose应用中使用Room数据库，数据库创建时通过回调预填充数据，但首次运行应用时，通过DAO的getAll()方法以LiveData方式获取数据无结果；重启应用后数据能正常展示，预填充数据仅在首次查询时不可用。

原因分析 #

1. 数据库实例重复创建：在Room的onCreate回调中，调用provideCategoryDatabase(appContext)获取DAO，导致递归触发数据库构建逻辑。由于Hilt的单例初始化尚未完成，会生成第二个数据库实例，预填充的数据被写入该实例中，而UI监听的是第一个实例的LiveData，因此首次启动无法读取到数据。重启应用时数据库已存在，onCreate回调不执行，此时Hilt返回的是包含预填充数据的第二个实例，所以能正常读取。
2. 非挂起DAO操作的潜在风险：insertAll方法未使用suspend修饰，虽然用单线程执行器避免了主线程阻塞，但不符合Room推荐的异步操作规范，可能导致数据更新通知不及时。

解决方法 #

1. 避免递归创建数据库实例，直接使用当前构建的实例 #

修改数据库提供方法，在onCreate回调中直接使用已构建的数据库实例获取DAO，而非再次调用Hilt的provide方法：

@Provides
@Singleton
fun provideCategoryDatabase(
    @ApplicationContext appContext: Context
): CategoryDatabase {
    val database = Room.databaseBuilder(
        appContext,
        CategoryDatabase::class.java,
        "categories-db"
    )
        .addCallback(object : RoomDatabase.Callback() {
            override fun onCreate(db: SupportSQLiteDatabase) {
                super.onCreate(db)
                // 使用IO协程执行预填充，确保操作在后台线程
                CoroutineScope(Dispatchers.IO).launch {
                    database.categoryDAO().insertAll(prepopulateData())
                }
                Log.d("RoomDatabase", "Database created and prepopulated!")
            }
        })
        .build()
    return database
}

2. 将DAO的插入方法改为挂起函数 #

遵循Room的最佳实践，将insertAll改为suspend方法，确保异步操作的安全性：

@Dao
interface CategoryDAO {
    @Query("SELECT * FROM categories")
    fun getAll(): LiveData<List<CategoryEntity>>

    @Insert
    suspend fun insertCategory(category: CategoryEntity)

    @Insert
    suspend fun insertAll(categories: List<CategoryEntity>) // 修改为suspend

    @Delete
    suspend fun deleteCategory(category: CategoryEntity)
}

3. 确保LiveData的正确观察（现有代码已满足） #

Composable中使用observeAsState观察LiveData的方式是正确的，当数据库数据更新时，LiveData会自动通知UI重组，无需额外修改：

val categories by categoryViewModel.categories.observeAsState(emptyList())

验证效果 #

修改后首次启动应用，预填充数据会被写入UI监听的数据库实例中，当插入完成后，LiveData会触发UI重组，直接展示预填充的分类数据，无需重启应用。

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