ViewPager2 onPageSelected被多次调用的解决方法

问题原因 #

ViewPager2的onPageSelected回调本身设计上就存在多次触发的可能，常见触发场景包括：

• 首次注册回调时，会主动回调一次当前选中的初始页位置
• 重复注册OnPageChangeCallback实例，多个回调同时生效
• 适配器调用notifyDataSetChanged刷新数据时，会重新触发选中回调
• 无限轮播场景下首尾页模拟跳转、滑动过程中预选中也会触发回调
• 滑动过程中状态抖动导致重复回调

可行解决方案 #

1. 增加位置幂等校验（最通用方案） #

在回调内部记录上一次处理过的有效位置，新回调的位置和记录值一致时直接拦截，不执行业务逻辑，同时注册回调前先反注册已有实例，避免重复添加回调。
核心实现代码：

private void setViewPagerPreviews() {
    // 注册前先反注册已有回调，避免重复添加回调实例
    if (onPageChangeCallback != null) {
        mEndLessViewpager.unregisterOnPageChangeCallback(onPageChangeCallback);
    }
    onPageChangeCallback = new ViewPager2.OnPageChangeCallback() {
        // 初始值设为无效位置，保证首次有效选中可以正常触发
        private int lastHandledPosition = -1;

        @Override
        public void onPageScrolled(int position, float positionOffset, int positionOffsetPixels) {
            super.onPageScrolled(position, positionOffset, positionOffsetPixels);
        }

        @Override
        public void onPageSelected(int position) {
            super.onPageSelected(position);
            // 相同位置重复回调直接拦截
            if (position == lastHandledPosition) {
                return;
            }
            lastHandledPosition = position;
            Log.e(TAG, "onPageSelected 有效触发，位置：" + position);
            // 此处执行你的视图滑动等业务逻辑
        }

        @Override
        public void onPageScrollStateChanged(int state) {
            super.onPageScrollStateChanged(state);
        }
    };
    mEndLessViewpager.registerForPageChangeCallback(onPageChangeCallback);
}

2. 结合滑动状态做严格校验（适用于需要滑动完成才触发逻辑的场景） #

如果你的业务逻辑需要等页面完全滑动停止后才执行，可以结合onPageScrollStateChanged的状态判断，仅当滑动状态为空闲SCROLL_STATE_IDLE、且位置发生变更时才执行业务逻辑，过滤滑动过程中的预选中回调。
核心修改点：

onPageChangeCallback = new ViewPager2.OnPageChangeCallback() {
    private int lastHandledPosition = -1;
    private int pendingSelectPosition = -1;
    private int currentScrollState = ViewPager2.SCROLL_STATE_IDLE;

    @Override
    public void onPageScrolled(int position, float positionOffset, int positionOffsetPixels) {
        super.onPageScrolled(position, positionOffset, positionOffsetPixels);
    }

    @Override
    public void onPageSelected(int position) {
        super.onPageSelected(position);
        // 非空闲状态下的选中先缓存，不处理
        if (currentScrollState != ViewPager2.SCROLL_STATE_IDLE) {
            pendingSelectPosition = position;
            return;
        }
        if (position == lastHandledPosition) {
            return;
        }
        lastHandledPosition = position;
        // 执行业务逻辑
        Log.e(TAG, "滑动停止后选中位置：" + position);
    }

    @Override
    public void onPageScrollStateChanged(int state) {
        super.onPageScrollStateChanged(state);
        currentScrollState = state;
        // 滑动停止后，处理缓存的选中位置
        if (state == ViewPager2.SCROLL_STATE_IDLE && pendingSelectPosition != lastHandledPosition) {
            lastHandledPosition = pendingSelectPosition;
            Log.e(TAG, "滑动停止后选中位置：" + pendingSelectPosition);
            // 执行业务逻辑
        }
    }
};

3. 无限轮播场景特殊处理 #

如果你用的是无限轮播封装的ViewPager2，回调返回的position是映射后的大整数索引，需要先把position转换成真实的数据源索引，再做重复判断，避免首尾跳转时相同真实页被判定为不同位置导致重复触发。

注意：onPageSelected多次触发属于ViewPager2的正常机制，不是组件bug，不需要修改系统或组件源码，只需要在业务层做好幂等拦截即可。

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