Kotlin RecyclerView分页问题：apiCall重复调用排查与解决

我来帮你分析下问题所在，以及给出可靠的解决方案：

问题根源 #

你当前的实现有两个核心问题导致重复调用：

1. 滚动回调的频繁触发：onScrolled方法会在滚动过程中被多次调用，哪怕只是微小的滚动。你的判断条件visibleItemCount + pastVisiblesItems >= totalItemCount会在最后几个item逐渐进入视野时多次满足，而isLoadMore的更新要等到接口返回后——这中间的几次回调都会触发apiCall()。
2. 触底判断不够精准：用findFirstVisibleItemPosition计算的方式，无法准确判断是否真的滚动到了最后一个完整（或部分）可见的item，容易提前触发加载。

正确的实现方案 #

我们需要从精准判断触底时机和添加请求状态锁两个方面来修正：

1. 优化触底判断逻辑 #

放弃用firstVisible + visibleCount的方式，改用findLastVisibleItemPosition()直接判断是否滚动到了列表最后一个item的位置，这是最准确的触底标志：

val layoutManager = recyclerView.layoutManager as GridLayoutManager
val lastVisibleItemPos = layoutManager.findLastVisibleItemPosition()
// 当最后一个可见item的位置等于总item数减1时，说明已经滚动到底部
val isAtBottom = lastVisibleItemPos == layoutManager.itemCount - 1

2. 添加请求状态锁 #

除了isLoadMore（标记是否还有更多数据），还要新增一个isLoading变量（标记当前是否正在请求数据）。在发起请求时立刻将isLoading设为true，请求完成（无论成功或失败）后再设为false，这样就能避免在请求过程中重复触发调用。

完整修正代码 #

private var isLoadMore = true // 是否还有更多数据可加载
private var isLoading = false // 当前是否正在请求数据
private var currentPage = 1
private val pageLimit = 20

recyclerView.addOnScrollListener(object : RecyclerView.OnScrollListener() {
    override fun onScrolled(recyclerView: RecyclerView, dx: Int, dy: Int) {
        super.onScrolled(recyclerView, dx, dy)
        
        // 只处理向下滚动的情况，向上滚动直接返回
        if (dy <= 0) return

        val layoutManager = recyclerView.layoutManager as GridLayoutManager
        val totalItemCount = layoutManager.itemCount
        val lastVisibleItemPos = layoutManager.findLastVisibleItemPosition()

        // 触发加载的条件：还有更多数据 + 不在请求中 + 确实滚动到底部
        if (isLoadMore && !isLoading && lastVisibleItemPos == totalItemCount - 1) {
            isLoading = true // 立刻锁住状态，防止重复请求
            currentPage++
            apiCall()
        }
    }
})

// 你的接口请求方法，这里假设是 Retrofit 异步请求
private fun apiCall() {
    someApiService.fetchData(page = currentPage, limit = pageLimit)
        .enqueue(object : Callback<DataResponse> {
            override fun onResponse(call: Call<DataResponse>, response: Response<DataResponse>) {
                isLoading = false // 请求完成，解锁状态
                
                response.body()?.let { data ->
                    // 将新数据添加到适配器
                    yourAdapter.addItems(data.dataList)
                    // 如果返回的数据量小于每页限制，说明没有更多数据了
                    isLoadMore = data.dataList.size == pageLimit
                } ?: run {
                    // 接口返回空数据，标记没有更多数据
                    isLoadMore = false
                }
            }

            override fun onFailure(call: Call<DataResponse>, t: Throwable) {
                isLoading = false // 请求失败也要解锁
                currentPage-- // 页面回退，允许用户重新触发加载
                // 这里可以添加加载失败的提示，比如Toast
            }
        })
}

额外注意事项 #

• LayoutManager兼容性：如果你的RecyclerView可能使用LinearLayoutManager，可以统一用RecyclerView.LayoutManager做类型判断，或者用findLastVisibleItemPosition()的通用方法（这个方法在所有LayoutManager的实现类中都有）。
• 状态保存：在屏幕旋转等配置变化时，要记得保存currentPage、isLoadMore、isLoading这些状态，避免重建后状态丢失导致逻辑混乱。
• 下拉刷新重置：如果有下拉刷新功能，在触发下拉刷新时要重置currentPage = 1、isLoadMore = true、isLoading = false，并清空原有数据重新加载第一页。

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