Android ViewPager与RecyclerView滑动冲突，求优化流畅滑动体验

阿华AIGC实验室

2026-5-11

解决ViewPager与内部RecyclerView的滑动冲突问题

这种滑动冲突确实挺闹心的，严重影响用户体验，我给你几个经过实践验证的解决方案，你可以根据自己的实际场景选择：

方案一：自定义RecyclerView，按滑动方向分配事件处理权

这是最通用的解决方案，核心逻辑是识别用户的滑动意图：如果是横向滑动（对应ViewPager的页面切换方向），就把触摸事件交给ViewPager处理；如果是纵向滑动，就让RecyclerView自己处理。

下面是Kotlin实现代码（Java版本逻辑完全一致，语法调整即可）：

class DirectionAwareRecyclerView(context: Context, attrs: AttributeSet?) : RecyclerView(context, attrs) {
    private var initialTouchX = 0f
    private var initialTouchY = 0f

    override fun onInterceptTouchEvent(event: MotionEvent): Boolean {
        when (event.action) {
            MotionEvent.ACTION_DOWN -> {
                // 记录触摸起始坐标
                initialTouchX = event.x
                initialTouchY = event.y
                // 默认让RecyclerView优先处理事件
                parent.requestDisallowInterceptTouchEvent(true)
            }
            MotionEvent.ACTION_MOVE -> {
                val deltaX = Math.abs(event.x - initialTouchX)
                val deltaY = Math.abs(event.y - initialTouchY)
                
                // 横向滑动距离大于纵向，说明用户想切换页面，交给ViewPager处理
                if (deltaX > deltaY) {
                    parent.requestDisallowInterceptTouchEvent(false)
                } else {
                    // 纵向滑动，继续由RecyclerView处理
                    parent.requestDisallowInterceptTouchEvent(true)
                }
            }
            MotionEvent.ACTION_UP, MotionEvent.ACTION_CANCEL -> {
                // 事件结束后，恢复父布局的拦截权限
                parent.requestDisallowInterceptTouchEvent(false)
            }
        }
        return super.onInterceptTouchEvent(event)
    }
}

之后把布局文件里的普通RecyclerView替换成这个自定义的DirectionAwareRecyclerView就可以了。

方案二：针对ViewPager2的极简优化（推荐）

如果你用的是官方推荐的新版ViewPager2，可以直接给内部的RecyclerView禁用嵌套滑动：

// 代码里设置
recyclerView.isNestedScrollingEnabled = false

或者在XML布局里添加属性：

<androidx.recyclerview.widget.RecyclerView
    ...
    android:nestedScrollingEnabled="false" />

因为ViewPager2本身就是基于RecyclerView实现的，禁用嵌套滑动后，触摸事件的分发逻辑会更合理，能直接解决大部分滑动冲突问题。

方案三：自定义旧版ViewPager（适配老项目）

如果你还在维护使用旧版ViewPager的项目，可以自定义ViewPager来处理冲突，核心是在onInterceptTouchEvent中判断滑动方向，决定是否拦截事件：

class CustomViewPager(context: Context, attrs: AttributeSet?) : ViewPager(context, attrs) {
    private var startX = 0f
    private var startY = 0f

    override fun onInterceptTouchEvent(ev: MotionEvent): Boolean {
        when (ev.action) {
            MotionEvent.ACTION_DOWN -> {
                startX = ev.x
                startY = ev.y
                // 禁止父布局拦截，确保ViewPager能拿到初始事件
                parent.requestDisallowInterceptTouchEvent(true)
            }
            MotionEvent.ACTION_MOVE -> {
                val dx = ev.x - startX
                val dy = ev.y - startY
                // 横向滑动更明显时，拦截事件进行页面切换
                if (Math.abs(dx) > Math.abs(dy)) {
                    parent.requestDisallowInterceptTouchEvent(true)
                } else {
                    // 纵向滑动时，交给子View（RecyclerView）处理
                    parent.requestDisallowInterceptTouchEvent(false)
                }
            }
            MotionEvent.ACTION_UP, MotionEvent.ACTION_CANCEL -> {
                parent.requestDisallowInterceptTouchEvent(false)
            }
        }
        return super.onInterceptTouchEvent(ev)
    }
}