Android中基于RecyclerView GridLayoutManager实现动态分页的异常问题排查

API 探路者

2026-5-6

我来帮你排查这个RecyclerView分页时滚动监听器自动触发的问题，咱们一步步拆解解决：

问题根源

当你调用notifyDataSetChanged()更新Adapter数据后，RecyclerView会执行重新布局操作，这个过程会触发OnScrollListener的onScrolled方法。而你当前的监听器判断逻辑在布局完成后刚好满足触发条件，导致自动加载；另外isLoading的状态管理也有漏洞，容易引发重复触发。

具体修复方案

1. 重构`isLoading`状态控制逻辑

你现在在onLoadMore开头就把isLoading设为false，这会导致布局完成后监听器再次满足条件触发加载。正确的做法是：加载开始时标记为正在加载，数据更新完成后再标记为加载结束。

修改onLoadMore代码：

override fun onLoadMore() {
    // 先标记为正在加载，避免重复触发
    scrollListener.isLoading = true
    // 用是否还有更多数据的逻辑替代原来的lastVisibleItem==limit
    if (hasMore) { // hasMore是API返回的是否还有下一页的标志，或者用pageNum和总页数判断
        motivationAdapter?.addLoadingView()
        getVideoAPi()
    } else {
        // 没有更多数据了，结束加载状态
        scrollListener.isLoading = false
    }
}

然后在API请求成功、Adapter更新完成后，再重置加载状态：

if (response.success == SOCKET_TRUE) {
    pageNum += 1
    hasMore = response.hasMore // 根据你的API实际字段调整
    if (limit>0) {
        motivationAdapter?.removeLoadingView()
    }
    limit += response?.data?.size!!
    updateAdapterCategory(response.data)
    // 数据更新完成，标记加载结束
    scrollListener.isLoading = false
}

2. 给滚动监听器加「手动滚动」判断

在RecyclerviewLoadMore的onScrolled方法里，增加**只有向下滚动（dy > 0）**才触发加载的逻辑，避免RecyclerView重新布局时的自动滚动误触发：

override fun onScrolled(recyclerView: RecyclerView, dx: Int, dy: Int) {
    super.onScrolled(recyclerView, dx, dy)
    // 只有向下滚动时才处理加载逻辑，过滤掉布局时的滚动
    if (dy <= 0) return

    totalItemCount = mLayoutManager.itemCount
    if (mLayoutManager is StaggeredGridLayoutManager) {
        val lastVisibleItemPositions = (mLayoutManager as StaggeredGridLayoutManager).findLastVisibleItemPositions(null)
        lastVisibleItem = getLastVisibleItem(lastVisibleItemPositions)
    } else if (mLayoutManager is GridLayoutManager) {
        lastVisibleItem = (mLayoutManager as GridLayoutManager).findLastVisibleItemPosition()
    } else if (mLayoutManager is LinearLayoutManager) {
        lastVisibleItem = (mLayoutManager as LinearLayoutManager).findLastVisibleItemPosition()
    }

    // 优化判断条件：排除初始数据过少的情况，同时确保不在加载中
    if (!isLoading && totalItemCount > visibleThreshold && totalItemCount <= lastVisibleItem + visibleThreshold) {
        mOnLoadMoreListener.onLoadMore()
    }
}

3. 修复分页触发的判断逻辑

你原来的if(scrollListener.lastVisibleItem==limit)判断逻辑有问题——limit是累计数据条数，lastVisibleItem是item位置，两者没有直接对比的意义。建议用API返回的「是否还有下一页」标志（比如has_more），或者用pageNum和总页数来判断是否需要加载，这样逻辑更准确。

4. 移除不必要的延迟添加监听器操作

你用Handler.postDelayed延迟1秒添加滚动监听器完全没必要，反而可能导致初始状态判断异常。直接在设置完LayoutManager和Adapter后就添加监听器：

// 去掉Handler延迟，直接初始化并添加监听器
scrollListener = RecyclerviewLoadMore(mLayoutManager as GridLayoutManager)
scrollListener.setOnLoadMoreListener(object : OnLoadMoreListener {
    override fun onLoadMore() {
        // ...修改后的加载逻辑
    }
})
rvMotivation?.addOnScrollListener(scrollListener)

总结修改后的核心要点

严格控制isLoading状态：加载开始设为true，数据更新完成设为false
仅在用户向下滚动时触发加载，过滤布局过程中的自动滚动
用API返回的「是否有更多数据」作为分页触发的判断依据，替代位置和数据条数的对比
移除不必要的延迟操作，保证监听器及时生效

这样修改后，滚动监听器就只会在用户手动向下滚动到列表底部时才触发加载，不会再出现数据更新后自动触发的问题了。

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

Android中基于RecyclerView GridLayoutManager实现动态分页的异常问题排查

问题根源 #

具体修复方案 #

1. 重构isLoading状态控制逻辑