Android中NestedScrollView嵌套ViewPager2时RecyclerView高度异常问题

你的核心问题出在嵌套滚动冲突：外层NestedScrollView和ViewPager2内部的RecyclerView同时处理滚动事件，导致RecyclerView的高度计算紊乱（比如内容被过度拉伸、滚动不顺畅或显示不全）。另外你要实现的「ViewPager滚动时隐藏顶部布局」需求，完全不需要依赖NestedScrollView，用Android官方的CoordinatorLayout+AppBarLayout是更标准且无冲突的方案。

问题根源拆解 #

1. 你把整个页面内容（顶部布局、TabLayout、ViewPager2）都套在了NestedScrollView里，但ViewPager2中的RecyclerView本身就是可滚动容器，嵌套后滚动事件会被NestedScrollView优先拦截，RecyclerView无法正确计算自身高度。
2. NestedScrollView的子布局设置了match_parent高度，会强制拉伸内部内容，进一步干扰RecyclerView的高度逻辑。

解决方案：重构为CoordinatorLayout架构 #

我们用官方组件实现顶部布局的滚动隐藏，同时彻底消除嵌套滚动冲突。

1. 重写home_fragment.xml布局

<androidx.coordinatorlayout.widget.CoordinatorLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    xmlns:app="http://schemas.android.com/apk/res-auto">

    <!-- 顶部可滚动隐藏的区域 -->
    <com.google.android.material.appbar.AppBarLayout
        android:layout_width="match_parent"
        android:layout_height="wrap_content">

        <!-- 顶部图片布局：滚动时会隐藏 -->
        <LinearLayout
            android:id="@+id/image"
            android:layout_width="match_parent"
            android:layout_height="150dp"
            android:orientation="horizontal"
            app:layout_scrollFlags="scroll|enterAlways" /> <!-- 滚动隐藏的核心属性 -->

        <!-- TabLayout：固定在顶部布局下方，滚动时不会隐藏 -->
        <com.google.android.material.tabs.TabLayout
            android:id="@+id/tabs"
            android:layout_width="match_parent"
            android:layout_height="wrap_content"
            app:layout_scrollFlags="enterAlways" />

    </com.google.android.material.appbar.AppBarLayout>

    <!-- ViewPager2与AppBarLayout关联，滚动触发顶部布局隐藏 -->
    <androidx.viewpager2.widget.ViewPager2
        android:id="@+id/view_pager"
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        app:layout_behavior="@string/appbar_scrolling_view_behavior" /> <!-- 关联AppBarLayout的关键 -->

</androidx.coordinatorlayout.widget.CoordinatorLayout>

2. 修正SecondFragment的RecyclerView高度

你在fragment_second.xml里把RecyclerView高度设为wrap_content，这在ViewPager2中会导致高度计算错误，改为match_parent：

<FrameLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:background="#1F4A8A"
    tools:context=".SecondFragment">

    <androidx.recyclerview.widget.RecyclerView
        android:id="@+id/second_fr_recyclerView"
        android:layout_width="match_parent"
        android:layout_height="match_parent"/> <!-- 改为match_parent -->

</FrameLayout>

3. 简化HomeFragment代码

原来的NestedScrollView相关变量可以直接移除，代码简化为：

private var fragments = mutableListOf(FirstFragment(), SecondFragment())

override fun onViewCreated(view: View, savedInstanceState: Bundle?) {
    super.onViewCreated(view, savedInstanceState)
    val tabLayout = view.findViewById<TabLayout>(R.id.tabs)
    val viewPager2 = view.findViewById<ViewPager2>(R.id.view_pager)
    val adapter = ViewPagerAdapter(context as FragmentActivity, fragments)
    viewPager2.adapter = adapter
    
    TabLayoutMediator(tabLayout, viewPager2) { tab, position ->
        tab.text = "Tab " + (position + 1)
    }.attach()
}

方案说明 #

• CoordinatorLayout+AppBarLayout是官方提供的滚动头部隐藏标准方案，能完美协调滚动事件，不会出现嵌套冲突。
• 去掉NestedScrollView后，ViewPager2内部的RecyclerView可以正常处理自身滚动和高度计算，彻底解决异常问题。
• app:layout_scrollFlags="scroll|enterAlways"属性控制顶部布局的滚动行为：向上滚动隐藏，向下滚动重新显示，完全匹配你的需求。

如果还有item高度异常的问题，可以检查recycler_item.xml的布局，确保item的高度设置合理，避免被过度拉伸。

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