CoordinatorLayout中NestedScrollView嵌套ViewPager2滑动不流畅

你遇到的慢速滑动无响应、快速滑动偶尔生效的异常，本质是多层滚动容器嵌套导致的触摸事件分发冲突，当前布局存在两个直接诱因：

• 给ViewPager2设置了android:nestedScrollingEnabled="false"，直接切断了ViewPager2和父容器NestedScrollView的嵌套滚动协商通道，慢速滑动时事件全被外层纵向滚动的NestedScrollView拦截，ViewPager2无法收到滑动事件
• 布局层级设计不合理：将带appbar_scrolling_view_behavior的NestedScrollView作为ViewPager2的父容器，相当于在纵向滚动容器内嵌套可横向/纵向滚动的ViewPager2，NestedScrollView会默认抢占所有滚动事件的处理权，只有快速滑动产生fling效果时，事件才可能穿透到ViewPager2，出现偶发响应的现象

按以下顺序逐层排查即可定位根因：

• 检查嵌套滚动开关：确认ViewPager2等可滚动子View是否被错误设置nestedScrollingEnabled="false"，该配置会直接关闭子View与父滚动容器的事件协商能力
• 检查布局层级合理性：确认是否存在多层同方向滚动容器嵌套的情况，比如纵向滚动的NestedScrollView内部再套纵向滚动的ViewPager2、RecyclerView，这类结构必然会触发事件冲突
• 检查事件拦截逻辑：确认父滚动容器是否实现了滑动方向判断逻辑，未做方向判断的纵向滚动容器会默认拦截所有触摸事件，导致横向滑动的子View无法收到事件
• 检查高度测量配置：确认NestedScrollView内部的子View高度配置是否合理，match_parent配置在NestedScrollView的直接子View中会导致测量值和实际滚动范围不匹配，加剧事件分发异常

方案1：调整布局层级（推荐，从根源解决冲突） #

当前布局存在冗余嵌套，带appbar_scrolling_view_behavior的滚动容器不需要是NestedScrollView，直接将ViewPager2作为AppBarLayout的同级可滚动区域即可，折叠联动逻辑交给ViewPager2内部页面的滚动控件实现，完全避免嵌套冲突。
修正后的核心布局代码：

<?xml version="1.0" encoding="utf-8"?>
<androidx.coordinatorlayout.widget.CoordinatorLayout
        xmlns:android="http://schemas.android.com/apk/res/android"
        xmlns:app="http://schemas.android.com/apk/res-auto"
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        android:fitsSystemWindows="true">
    <com.google.android.material.appbar.AppBarLayout
            android:layout_width="match_parent"
            android:layout_height="@dimen/app_bar_height"
            android:background="@color/white">
        <com.google.android.material.appbar.CollapsingToolbarLayout
                android:layout_width="match_parent"
                android:layout_height="@dimen/app_bar_height"
                android:id="@+id/toolbar_layout"
                style="@style/Widget.MaterialComponents.Toolbar.Primary"
                app:toolbarId="@+id/title_toolbar"
                app:layout_scrollFlags="scroll|enterAlwaysCollapsed"
                app:contentScrim="?attr/colorPrimary">
            <!-- 头部栏内容 -->
        </com.google.android.material.appbar.CollapsingToolbarLayout>
    </com.google.android.material.appbar.AppBarLayout>

    <!-- 移除外层冗余NestedScrollView，直接给ViewPager2设置联动behavior -->
    <androidx.viewpager2.widget.ViewPager2
            app:layout_behavior="@string/appbar_scrolling_view_behavior"
            android:layout_width="match_parent"
            android:layout_height="match_parent"
            android:id="@+id/view_pager"/>

    <androidx.cardview.widget.CardView
            android:layout_width="match_parent"
            android:layout_height="?android:actionBarSize"
            android:layout_gravity="bottom"
            app:layout_behavior=".ui.NavBehavior"
            android:id="@+id/main_nav_container">
    </androidx.cardview.widget.CardView>
</androidx.coordinatorlayout.widget.CoordinatorLayout>

注意：ViewPager2内部每个Fragment的根布局如果是可滚动控件（RecyclerView、NestedScrollView），无需额外配置即可自动和AppBarLayout联动折叠，不会出现滑动冲突。

方案2：保留现有NestedScrollView嵌套结构的冲突修复 #

如果有特殊业务需求必须保留NestedScrollView包裹ViewPager2的结构，按以下步骤修改：

1. 删除ViewPager2配置中的android:nestedScrollingEnabled="false"，恢复ViewPager2本身的嵌套滚动协商能力
2. 自定义支持横向滑动兼容的NestedScrollView，重写事件拦截逻辑，当判定用户为横向滑动时不拦截事件，将事件交给ViewPager2处理，代码示例：

class HorizontalCompatibleNestedScrollView @JvmOverloads constructor(
    context: Context,
    attrs: AttributeSet? = null,
    defStyleAttr: Int = 0
) : NestedScrollView(context, attrs, defStyleAttr) {
    private var touchStartX = 0f
    private var touchStartY = 0f
    private val touchSlop = ViewConfiguration.get(context).scaledTouchSlop

    override fun onInterceptTouchEvent(ev: MotionEvent): Boolean {
        when (ev.action) {
            MotionEvent.ACTION_DOWN -> {
                touchStartX = ev.x
                touchStartY = ev.y
                parent.requestDisallowInterceptTouchEvent(true)
            }
            MotionEvent.ACTION_MOVE -> {
                val dx = Math.abs(ev.x - touchStartX)
                val dy = Math.abs(ev.y - touchStartY)
                // 横向滑动距离大于纵向、且超过系统触摸阈值时，不拦截事件，交给子View处理
                if (dx > dy && dx > touchSlop) {
                    return false
                }
            }
            MotionEvent.ACTION_UP, MotionEvent.ACTION_CANCEL -> {
                parent.requestDisallowInterceptTouchEvent(false)
            }
        }
        return super.onInterceptTouchEvent(ev)
    }
}

3. 将布局中原生的NestedScrollView替换为上述自定义的HorizontalCompatibleNestedScrollView即可。

• 不要给嵌套在滚动容器内的可滚动子View随意设置nestedScrollingEnabled=false，该属性会切断嵌套滚动的事件协商链路，直接导致滑动事件分发异常
• NestedScrollView本身设计为承载纵向滚动内容，内部嵌套横向滚动控件时必须添加滑动方向判断的拦截逻辑，否则默认逻辑必然出现滑动冲突
• 如果ViewPager2内部页面存在纵向滚动列表，不要在外层再套一层纵向滚动容器（NestedScrollView），多层纵向滚动容器嵌套不仅会引发滑动冲突，还会导致RecyclerView复用失效、列表卡顿、内存占用升高等问题

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