Android使用Paging3加载Room预填充数据首次启动无内容问题求解

问题根因 #

你遇到的问题是典型的异步预填充时序差+Paging3无数据变更监听导致的：

1. RoomDatabase.Callback的onCreate方法是异步执行的，首次启动APP时，页面初始化请求Paging3加载数据的时机，早于预填充数据插入数据库的完成时机，首次查询拿到空结果
2. 你当前Dao的searchQuiz方法返回的是普通的一次性List，没有可观察能力，后续预填充插入完成后，Paging3感知不到数据发生了变更，不会主动触发重查，所以列表一直为空。重启APP时数据库已经有预填充好的数据，首次查询就能拿到结果，所以正常显示。

最优解决方案：使用Room原生Paging3集成（自动监听数据变更） #

Room官方已经实现了和Paging3的联动，Dao查询直接返回PagingSource时，会自动监听表数据变化，一旦有插入/更新/删除操作，会自动触发Paging重加载，完全不用手动处理刷新逻辑，修改步骤如下：

1. 修改QuizDao查询方法 #

把原有一次性查询的suspend方法，改为返回PagingSource，无需手动加LIMIT，Room会自动处理分页逻辑：

@Dao
interface QuizDao {

    // 去掉suspend、去掉LIMIT参数，返回值改为PagingSource
    @Query("SELECT * FROM quiz WHERE type=:type AND question LIKE '%' || :question || '%'")
    fun searchQuiz(type: String, question: String = ""): PagingSource<Int, QuizEntity>

    @Insert(onConflict = OnConflictStrategy.REPLACE)
    suspend fun insert(quizEntity: QuizEntity)

    // 可选优化：新增批量插入方法，提升预填充效率
    @Insert(onConflict = OnConflictStrategy.REPLACE)
    suspend fun insertAll(quizList: List<QuizEntity>)

    @Query("DELETE FROM quiz")
    suspend fun deleteAll()
}

2. 移除自定义的QuizPagingSource，直接用Dao返回的PagingSource #

修改QuizRepository代码，不需要再自己实现PagingSource：

class QuizRepository @Inject constructor(private val quizDao: QuizDao) {

  fun getEnglishQuiz(query: String = ""): Flow<PagingData<QuizEntity>> {
    return Pager(PagingConfig(PAGE_SIZE)) {
      // 直接传入Dao返回的PagingSource即可
      quizDao.searchQuiz("en", query)
    }.flow
  }

  companion object {
    private const val PAGE_SIZE = 25
  }
}

3. 可选优化：提升预填充效率 #

修改AppDatabase的fillQuizData方法，把循环单条插入改为批量插入：

suspend fun fillQuizData(context: Context, quizDao: QuizDao) {
    val jsonArray = FileUtil.loadJsonArray(context, R.raw.quiz)
    try {
        jsonArray?.let {
            val quizList = mutableListOf<QuizEntity>()
            for (i in 0 until it.length()) {
                val item = it.getJSONObject(i)
                val isAnswer = item.getInt("answer")
                quizList.add(
                    QuizEntity(
                        0,
                        item.getString("question"),
                        item.getString("type"),
                        isAnswer == 1,
                    )
                )
            }
            // 批量插入，减少IO操作
            quizDao.insertAll(quizList)
        }
    } catch (exception: JSONException) {
        exception.printStackTrace()
    }
}

修改完成后，首次启动预填充数据插入完成后，Room会自动通知Paging3刷新数据，列表会自动显示内容，不需要手动调用刷新方法。

替代方案（不改动现有自定义PagingSource逻辑） #

如果你不想修改现有自定义PagingSource的实现，可以手动监听数据变更触发刷新：

1. 在QuizDao中新增监听数据总数的Flow方法：

@Query("SELECT COUNT(*) FROM quiz")
fun getQuizCount(): Flow<Int>

2. 在Activity中监听这个Flow，当总数发生变化时调用PagingAdapter的refresh方法：

lifecycleScope.launch {
    appDatabase.quizDao().getQuizCount()
        .distinctUntilChanged()
        .collect {
            quizAdapter.refresh()
        }
}

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