CoordinatorLayout嵌套NestedScrollView与ViewPager首Fragment滚动异常求助

我之前也碰到过类似的嵌套滚动冲突问题，结合你的布局结构和症状来看，大概率是滚动事件传递混乱或者首次布局测量未完成导致的，给你几个逐步排查和解决的方向：

1. 移除ViewPager上重复的CustomScrollingBehavior #

看你的布局代码，NestedScrollView和内部的ViewPager都设置了app:layout_behavior="CustomScrollingBehavior"——这是典型的滚动事件冲突诱因。

CoordinatorLayout的Behavior是给直接子View设置的，ViewPager作为NestedScrollView的子View，完全不需要额外设置Behavior。直接删掉ViewPager的这个属性即可：

<android.support.v4.view.ViewPager 
    android:id="@+id/viewPager" 
    android:layout_width="match_parent" 
    android:layout_height="wrap_content" 
    android:nestedScrollingEnabled="true"
    <!-- 移除这一行：app:layout_behavior="CustomScrollingBehavior" -->
/>

2. 调整RecyclerView的嵌套滚动触发逻辑 #

虽然你已经给ViewPager开了nestedScrollingEnabled，但首次加载时NestedScrollView可能会抢占滚动事件，导致RecyclerView无法响应。可以在首个Fragment的RecyclerView初始化时，手动触发一次微小滚动来唤醒滚动逻辑：

// 在首个Fragment的onViewCreated方法中
RecyclerView recyclerView = view.findViewById(R.id.your_recycler_id);
recyclerView.setNestedScrollingEnabled(true);

// 延迟300ms，确保CollapsingToolbar状态稳定后触发
new Handler(Looper.getMainLooper()).postDelayed(() -> {
    if (recyclerView.isAttachedToWindow()) {
        recyclerView.scrollBy(0, 1);
        recyclerView.scrollBy(0, -1);
    }
}, 300);

3. 检查自定义CustomScrollingBehavior的逻辑 #

如果上面的方法没用，问题大概率出在你的自定义Behavior里。重点排查这两个核心方法：

• onStartNestedScroll：确保CollapsingToolbar完全折叠后，返回false，让内部RecyclerView接管滚动事件，而不是NestedScrollView继续拦截。
• onNestedScroll：当Toolbar已完全折叠时，不要消费滚动事件，直接传递给子View。

示例调整代码：

@Override
public boolean onStartNestedScroll(@NonNull CoordinatorLayout coordinatorLayout, @NonNull View child, @NonNull View directTargetChild, @NonNull View target, int axes, int type) {
    AppBarLayout appBarLayout = findAppBarLayout(coordinatorLayout);
    if (appBarLayout == null) return super.onStartNestedScroll(coordinatorLayout, child, directTargetChild, target, axes, type);
    
    int totalScrollRange = appBarLayout.getTotalScrollRange();
    int verticalOffset = Math.abs(appBarLayout.getTop());
    // 完全折叠时，不拦截滚动事件
    if (verticalOffset == totalScrollRange) {
        return false;
    }
    return super.onStartNestedScroll(coordinatorLayout, child, directTargetChild, target, axes, type);
}

// 辅助方法：找到布局中的AppBarLayout
private AppBarLayout findAppBarLayout(CoordinatorLayout coordinatorLayout) {
    for (int i = 0; i < coordinatorLayout.getChildCount(); i++) {
        View child = coordinatorLayout.getChildAt(i);
        if (child instanceof AppBarLayout) {
            return (AppBarLayout) child;
        }
    }
    return null;
}

4. 延迟触发首个Fragment的布局刷新 #

有时候首次加载时，CollapsingToolbar的状态还没稳定，RecyclerView的测量布局会出现偏差。可以通过ViewPager的页面监听，在首次选中第一个页面时延迟请求布局刷新：

viewPager.addOnPageChangeListener(new ViewPager.SimpleOnPageChangeListener() {
    @Override
    public void onPageSelected(int position) {
        if (position == 0) {
            new Handler(Looper.getMainLooper()).postDelayed(() -> {
                Fragment firstFragment = getSupportFragmentManager()
                        .findFragmentByTag("android:switcher:" + viewPager.getId() + ":0");
                if (firstFragment != null && firstFragment.isResumed()) {
                    RecyclerView recyclerView = firstFragment.getView().findViewById(R.id.your_recycler_id);
                    if (recyclerView != null) {
                        recyclerView.requestLayout();
                    }
                }
            }, 500);
        }
    }
});

建议你按顺序尝试这些方法，先从移除重复Behavior开始——这是最常见的坑，如果还不行再逐步排查其他方向。

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