如何避免Paging3库中选中/取消列表项时滚动至顶部？

场景与问题 #

我在ViewModel中收集Room数据库的分页数据流：

viewModelScope.launch {
    repository.getMessagesStream(project).cachedIn(viewModelScope).collectLatest {
        _uiState.value = UiState.Content(it)
    }
}

UI层观察状态并提交给PagingAdapter：

lifecycleScope.launch {
    adapter.submitData(messageList)
}

适配器中实现选中/取消逻辑，直接更新Room的isSelected字段：

fun upDateSelectedMessage(messageId: Int, isSelected: Boolean) {
    viewModelScope.launch {
        withContext(Dispatchers.IO) {
            repository.updateSelectedMessage(isSelected = isSelected, messageId = messageId)
        }
    }
}

分页数据流实现：

fun getMessagesStream(): Flow<PagingData<Message>> {
    val pagingSourceFactory = { appDao.getMessages() }

    return Pager(
        config = PagingConfig(pageSize = 30, enablePlaceholders = false),
        pagingSourceFactory = pagingSourceFactory
    ).flow
}

问题：滚动到列表下方选中/取消项时，列表会自动滚回顶部。

问题原因 #

更新Room中的isSelected字段后，appDao.getMessages()返回的数据源发生变化，Paging会重新创建PagingSource并发射全新的PagingData。ViewModel的collectLatest收到新数据后更新UI状态，UI层再次调用adapter.submitData()，而submitData默认会重置列表滚动位置，导致回到顶部。

解决方案 #

1. 配置Room与Paging支持局部差分更新

确保Message实体有稳定主键，且DAO查询包含固定排序条件，让Paging能识别局部数据变化：

• 实体定义示例：

@Entity(tableName = "messages")
data class Message(
    @PrimaryKey val id: Int,
    val content: String,
    var isSelected: Boolean,
    // 其他字段
)

• DAO查询添加稳定排序：

@Query("SELECT * FROM messages ORDER BY id ASC")
fun getMessages(): PagingSource<Int, Message>

这样Paging会自动对比新旧数据的差异，仅更新变化的项，不会触发全量刷新重置滚动位置。

2. 优化UI层的状态观察逻辑

使用repeatOnLifecycle确保仅在页面活跃时观察状态，避免不必要的重复提交：

lifecycleScope.launch {
    repeatOnLifecycle(Lifecycle.State.STARTED) {
        viewModel.uiState.collect { state ->
            when (state) {
                is UiState.Content -> adapter.submitData(state.data)
                // 处理其他状态
            }
        }
    }
}

PagingAdapter会自动处理差分更新，不会因为新PagingData的提交而重置滚动位置。

3. 先更新内存状态再同步数据库

先更新适配器中的内存数据并局部刷新，再异步更新Room，避免触发PagingSource重新加载：

fun toggleMessageSelection(position: Int, isSelected: Boolean) {
    val message = getItem(position) ?: return
    // 更新内存中的对象状态
    val updatedMessage = message.copy(isSelected = isSelected)
    // 局部刷新该项
    notifyItemChanged(position)
    
    // 异步同步到数据库
    viewModelScope.launch(Dispatchers.IO) {
        repository.updateSelectedMessage(isSelected = isSelected, messageId = message.id)
    }
}

这种方式能让用户立即看到选中状态变化，同时完全保留滚动位置，后续数据库同步完成后，Paging的差分更新也不会影响当前滚动状态。

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