如何降低Android ViewPager2滑动灵敏度避免滚动时误触换页？

问题本质 #

ViewPager2 内部通过封装 RecyclerView 实现滑动逻辑，默认使用系统级的最小滑动判定阈值（scaledTouchSlop，通常约8dp）来识别水平切页意图。当你在页面内垂直滚动列表时，手指附带的微小水平位移很容易超过这个极小的阈值，导致ViewPager2提前拦截触摸事件触发切页，打断正常的垂直滚动操作。

实现思路 #

不需要修改原有适配器、Fragment的代码，也不需要自定义ViewPager2控件，直接在Activity初始化ViewPager的流程中，调整滑动拦截的判定逻辑即可：

• 放大触发水平切页所需的最小水平位移阈值，过滤手指垂直滚动时产生的微小水平偏移
• 增加方向校验：只有当水平位移明显大于垂直位移时，才判定用户的切页意图，避免垂直滚动场景的误触发

具体实现代码 #

在你现有的initViewPager方法中补充如下逻辑即可：

private fun initViewPager() {
    adapterView.addFragment(ElencoFragment())
    adapterView.addFragment(TestataFragment())
    adapterView.addFragment(CorpoFragment())
    adapterView.notifyDataSetChanged()

    viewPager.adapter = adapterView

    // 获取ViewPager2内部承载滑动逻辑的RecyclerView实例
    val innerRecyclerView = ViewPager2::class.java.getDeclaredField("mRecyclerView").apply {
        isAccessible = true
    }.get(viewPager) as RecyclerView

    // 获取系统默认滑动判定阈值，根据实际体验调整倍数
    val defaultTouchSlop = ViewConfiguration.get(this).scaledTouchSlop
    // 将触发切页的最小水平位移设为默认值的3倍，可根据手感调整区间
    val customTouchSlop = defaultTouchSlop * 3

    innerRecyclerView.addOnItemTouchListener(object : RecyclerView.SimpleOnItemTouchListener() {
        private var startX = 0f
        private var startY = 0f
        private var isCaptureTouch = false

        override fun onInterceptTouchEvent(rv: RecyclerView, e: MotionEvent): Boolean {
            when (e.action) {
                MotionEvent.ACTION_DOWN -> {
                    startX = e.rawX
                    startY = e.rawY
                    isCaptureTouch = false
                }
                MotionEvent.ACTION_MOVE -> {
                    val horizontalDistance = abs(e.rawX - startX)
                    val verticalDistance = abs(e.rawY - startY)
                    // 满足两个条件才判定为切页意图：
                    // 1. 水平位移超过自定义的高阈值
                    // 2. 水平位移明显大于垂直位移，说明用户操作方向是水平的
                    if (horizontalDistance > customTouchSlop && horizontalDistance > verticalDistance) {
                        isCaptureTouch = true
                    }
                }
            }
            // 只有判定为切页意图时才拦截触摸事件，否则事件交由页面内部的滚动控件处理
            return isCaptureTouch
        }
    })
}

注意事项 #

• 阈值倍数可以根据实际手感调整：倍数太低达不到防误触效果，太高会导致正常左右切页需要滑动更大距离才有响应，2~3倍默认阈值是比较通用的体验平衡值
• 该实现不会破坏ViewPager2原有的Fragment缓存、预加载、边缘滑动效果等核心能力
• 适配AndroidX ViewPager2 1.0.0及以上的所有稳定版本，内部mRecyclerView字段为公开的稳定实现，不存在版本兼容问题

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