如何结合RecyclerView GridLayoutManager使用Paging Library并解决分页起始项异常

这个坑我之前踩过！核心原因是你直接照搬了LinearLayoutManager的分页逻辑，没适配Grid布局的列数特性，导致PagedList的加载起始位置计算错误，破坏了原本的奇偶排列规则。

问题分析 #

从你的例子来看，初始列表到10结束，预期下一页应该从11（奇数）开始，但实际从8（偶数）加载，说明你的分页触发逻辑或者DataSource的加载起始key计算错了——大概率是误用了findLastVisibleItemPosition()的返回值，Grid布局下这个position对应的是item的索引，而不是行索引，直接拿来当加载起始点就会导致重复加载+起始位置偏移。

具体解决方案 #

1. 修正DataSource的分页起始计算

假设你用的是PageKeyedDataSource，要确保下一页的加载起始值是上一页最后一个item的数值+1，而不是基于RecyclerView的可见position。比如：

override fun loadAfter(params: LoadParams<Int>, callback: LoadCallback<Int, Int>) {
    // params.key是上一页最后一个item的数值（比如10）
    val nextStartValue = params.key + 1
    // 加载从nextStartValue开始的N个item（这里举例加载10个）
    val newItems = (nextStartValue until nextStartValue + 10).toList()
    // 下一页的key传当前页最后一个数值（比如10+9=19）
    callback.onResult(newItems, nextStartValue + 9)
}

这样每一页的第一个item数值必然是奇数（上一页最后一个是偶数，+1就是奇数），完美匹配你的预期。

2. 调整滚动加载的触发逻辑

别再直接用findLastVisibleItemPosition()来判断加载时机了，改用当前列表的最后一个item数值来触发：

recyclerView.addOnScrollListener(object : RecyclerView.OnScrollListener() {
    private var isLoading = false

    override fun onScrolled(recyclerView: RecyclerView, dx: Int, dy: Int) {
        super.onScrolled(recyclerView, dx, dy)
        val layoutManager = recyclerView.layoutManager as GridLayoutManager
        val totalItemCount = layoutManager.itemCount
        val lastVisiblePos = layoutManager.findLastVisibleItemPosition()
        
        // 当最后可见item距离列表底部还有2个时触发加载（可根据需求调整阈值）
        if (lastVisiblePos >= totalItemCount - 2 && !isLoading) {
            isLoading = true
            // 获取当前列表最后一个item的数值
            val lastItemValue = adapter.currentList?.lastOrNull() ?: 0
            // 通知DataSource加载下一页
            // 这里要根据你的DataSource实现来调用对应的加载方法
            dataSourceTrigger.loadNextPage(lastItemValue)
        }
    }
})

3. 禁用PagedList占位符（非必须但推荐）

如果你的业务不需要占位符，建议在配置PagedList时关闭它，避免Grid布局因占位符导致的位置计算异常：

val config = PagedList.Config.Builder()
    .setPageSize(10)
    .setEnablePlaceholders(false) // 关闭占位符
    .build()

4. 确认GridLayoutManager的Span配置

确保你的GridLayoutManager是按2列配置的，且没有特殊的SpanSizeLookup干扰：

val layoutManager = GridLayoutManager(context, 2)
// 如果你没有特殊的跨列item，不需要设置SpanSizeLookup，默认每个item占1列
recyclerView.layoutManager = layoutManager

验证效果 #

按照上面的配置调整后，初始列表到10结束，下一页会加载11-20，显示出来就是：
11 12
13 14
...
完全符合你预期的“新列表第一个项为奇数”的规则。

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