RecyclerView 滚动监听器设置实现分页加载的正确方法

RecyclerView 的 addOnScrollListener() 未被触发，通常并非 API 使用错误，而是因重复注册监听器导致后注册的被覆盖，或监听器被意外移除/未生效；本文详解排查逻辑、正确注册方式及分页加载的最佳实践。

先说一个许多开发者都曾踩过的雷：RecyclerView 的 addOnScrollListener() 失效时，先别急着怀疑 API 存在 Bug，十有八九问题出在监听器的注册逻辑上。不是布局写错了，也不是数据绑定出了问题，而是监听器注册本身发生了“冲突”。

在 Android 开发中，addOnScrollListener() 是实现“滚动到底部加载更多”功能的常用方法。但问题在于，当你满怀信心写好回调后，运行时滚动到底部，却发现什么都没发生——onScrolled() 如同人间蒸发。根据你提供的案例，根本原因并非生命周期错乱，而是监听器注册冲突。Android 并不禁止对同一个 RecyclerView 实例多次调用 addOnScrollListener()，它会默默将所有监听器存入内部列表，并在滚动发生时依次回调。这听起来合理，但问题在于，当多个组件（例如 Activity 和 Dialog）各自持有同一个 RecyclerView 的引用，并分别注册监听器时，情况就变得微妙起来。

假设你在 Activity 的 onCreate() 中注册了一个监听器，然后又在某个弹窗 Dialog 的初始化逻辑中，对同一个 recent_comments_view 再次调用 addOnScrollListener()。此时两个监听器都会生效，但调试时你只关注 Dialog 里的滚动行为，误以为 Activity 的监听器“干扰”了它——实际上，你滚动的是 Dialog 中的 RecyclerView，而监听器却注册在 Activity 的同名视图上，或者相反。这种“张冠李戴”的错觉，正是监听器“静默失效”的常见元凶。

要避开这个陷阱，其实有章可循：

1. 确保唯一性：每个 RecyclerView 实例应只由一个明确的业务模块（例如 Fragment 或专属的 ViewHolder 管理类）负责注册滚动监听器，避免多个地方同时插手。
2. 避免跨作用域复用监听器实例：不要在 Dialog 中直接操作 Activity 的 RecyclerView 引用。如果逻辑需要复用，应封装一个 EndlessScrollListener 类，在不同上下文中独立实例化。
3. 使用 findLastCompletelyVisibleItemPosition() 时注意边界安全：该方法返回 -1 表示没有完全可见的项（例如列表为空，或 item 高度大于 RecyclerView），务必做好判空处理。

recent_comments_view.addOnScrollListener(new RecyclerView.OnScrollListener() {    @Override    public void onScrolled(@NonNull RecyclerView recyclerView, int dx, int dy) {        super.onScrolled(recyclerView, dx, dy);        LinearLayoutManager layoutManager = (LinearLayoutManager) recyclerView.getLayoutManager();        if (layoutManager == null || itemList == null || itemList.isEmpty()) return;        int lastVisiblePos = layoutManager.findLastCompletelyVisibleItemPosition();        // 防止越界：仅当有可见项且已达末尾时触发        if (lastVisiblePos >= 0 && lastVisiblePos == itemList.size() - 1) {            if (!isLoadingMore) { // 添加加载状态锁，防止重复请求                isLoadingMore = true;                fetchNextBatch(documents.get(documents.size() - 1));            }        }    }});

需要注意的几个细节：

• findLastCompletelyVisibleItemPosition() 返回 -1 的情况，务必判空，否则可能引发越界异常。
• 建议引入 isLoadingMore 标志位，避免快速滑动时触发多次重复请求，这是分页加载的常规做法。
• 如果使用 ViewPager2 + Fragment 或 DialogFragment，请确认 RecyclerView 是在正确的 Fragment 生命周期内完成初始化与监听器绑定的，推荐在 onViewCreated() 中设置。
• 排查时，可用 Log.d("Scroll", "onScrolled: dy=" + dy) 快速验证监听器是否被调用，从而定位是“未注册”还是“条件未满足”。

归根结底，addOnScrollListener() 失效极少是因为 API 自身的限制，绝大多数情况指向注册时机、作用域混淆或条件判断疏漏。养成“单点注册、状态防护、日志验证”的开发习惯，这类问题基本就能从根源上避免。