Kotlin中ViewPager2内嵌RecyclerView滑动与布局问题求解

你遇到的两类问题都不是组件原生滑动冲突bug，核心是布局层级、约束配置、代码逻辑三处错误导致的：

• 层级错误：全局组件ViewPager2被错放到单个Tab页的Fragment布局里，和同布局内的RecyclerView完全重叠，和主布局的TabLayout完全脱离绑定关系，才会出现RecyclerView悬浮全局、Tab切换失效的问题
• 约束错误：主布局内TabLayout同时绑定上下约束到父布局，ViewPager2没有在主布局预留显示位置；Fragment内RecyclerView和ViewPager2都设置四边约束到父布局，叠放状态下触摸事件被上层View强行拦截，才会出现滑动互斥的现象
• 逻辑缺失：没有给ViewPager2配置Fragment适配器，也没有做TabLayout和ViewPager2的联动绑定，点击Tab自然不会触发页面切换

第一步：重构主布局content_main.xml #

把ViewPager2移到主布局和TabLayout同层级，TabLayout固定在顶部，ViewPager2占满TabLayout下方剩余空间，删掉占满全屏的无效NavHostFragment（如果需要导航组件可以放到对应Tab页内部，不要全局占满）：

<?xml version="1.0" encoding="utf-8"?>
<androidx.constraintlayout.widget.ConstraintLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    xmlns:tools="http://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    app:layout_behavior="@string/appbar_scrolling_view_behavior"
    tools:showIn="@layout/app_bar_main"
    tools:context=".MainActivity">

    <com.google.android.material.tabs.TabLayout
        android:id="@+id/tablayout"
        android:layout_width="match_parent"
        android:layout_height="60dp"
        app:layout_constraintTop_toTopOf="parent"
        app:layout_constraintStart_toStartOf="parent"
        app:layout_constraintEnd_toEndOf="parent">

        <com.google.android.material.tabs.TabItem
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:text="@string/recent" />

        <com.google.android.material.tabs.TabItem
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:text="@string/saved" />

        <com.google.android.material.tabs.TabItem
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:text="@string/tools" />
    </com.google.android.material.tabs.TabLayout>

    <androidx.viewpager2.widget.ViewPager2
        android:id="@+id/viewpager"
        android:layout_width="match_parent"
        android:layout_height="0dp"
        app:layout_constraintTop_toBottomOf="@id/tablayout"
        app:layout_constraintStart_toStartOf="parent"
        app:layout_constraintEnd_toEndOf="parent"
        app:layout_constraintBottom_toBottomOf="parent"/>

</androidx.constraintlayout.widget.ConstraintLayout>

注意：ViewPager2高度用0dp即约束匹配模式，配合上下约束自动占满剩余空间，不要用match_parent否则会被顶部TabLayout遮挡。

第二步：修改单个Tab页布局fragment_recent.xml #

删掉不属于单Tab页的ViewPager2，只保留当前页需要的RecyclerView即可：

<?xml version="1.0" encoding="utf-8"?>
<androidx.constraintlayout.widget.ConstraintLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    xmlns:tools="http://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:background="@color/black">

    <androidx.recyclerview.widget.RecyclerView
        android:id="@+id/rv_status_list"
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        android:paddingStart="15dp"
        android:paddingTop="15dp"
        app:layout_constraintBottom_toBottomOf="parent"
        app:layout_constraintEnd_toEndOf="parent"
        app:layout_constraintStart_toStartOf="parent"
        app:layout_constraintTop_toTopOf="parent"
        tools:listitem="@layout/status_item" />

</androidx.constraintlayout.widget.ConstraintLayout>

之前设置的75dp顶部padding是为了避让错放的ViewPager2，结构修正后改成常规内边距即可，同时删掉Fragment根布局上不生效的tools:showIn、layout_behavior冗余属性。

第三步：在MainActivity中配置ViewPager2与Tab联动 #

ViewPager2的初始化、适配器配置、Tab绑定逻辑必须放在宿主Activity中，不要写在单个Tab页Fragment里：

class MainActivity : AppCompatActivity() {
    private lateinit var binding: ActivityMainBinding

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        binding = ActivityMainBinding.inflate(layoutInflater)
        setContentView(binding.root)

        // 配置ViewPager2页面适配器
        binding.viewpager.adapter = object : FragmentStateAdapter(this) {
            override fun getItemCount(): Int = 3

            override fun createFragment(position: Int): Fragment {
                return when(position) {
                    0 -> tabrecentFragment()
                    1 -> SavedFragment() // 替换为你自己的已保存Tab页Fragment
                    2 -> ToolsFragment() // 替换为你自己的工具Tab页Fragment
                    else -> tabrecentFragment()
                }
            }
        }

        // 绑定TabLayout与ViewPager2，实现点击Tab切换、滑动页面同步Tab状态
        TabLayoutMediator(binding.tablayout, binding.viewpager) { tab, position ->
            tab.text = when(position) {
                0 -> getString(R.string.recent)
                1 -> getString(R.string.saved)
                2 -> getString(R.string.tools)
                else -> ""
            }
        }.attach()

        // 配置ViewPager2为水平滑动
        binding.viewpager.orientation = ViewPager2.ORIENTATION_HORIZONTAL
    }
}

注意：使用TabLayoutMediator需要先在模块build.gradle中导入material依赖，版本和你当前项目的material库版本保持一致即可。ViewPager2原生已经实现了和内部RecyclerView的嵌套滑动适配，不需要额外写事件拦截代码。

第四步：完善Tab页Fragment代码 #

在Tab页Fragment中只处理当前页RecyclerView的初始化逻辑即可：

class tabrecentFragment : Fragment() {
    private var binding: FragmentRecentBinding? = null
    override fun onCreateView(
        inflater: LayoutInflater, container: ViewGroup?,
        savedInstanceState: Bundle?
    ): View? {
        binding = FragmentRecentBinding.inflate(inflater, container, false)
        return binding?.root
    }

    override fun onViewCreated(view: View, savedInstanceState: Bundle?) {
        super.onViewCreated(view, savedInstanceState)
        binding?.rvStatusList?.apply {
            layoutManager = LinearLayoutManager(requireContext())
            adapter = YourStatusListAdapter() // 替换为你自己的列表适配器
        }
    }

    override fun onDestroyView() {
        super.onDestroyView()
        binding = null
    }
}

• 左右滑动ViewPager2区域可以正常切换三个Tab页，Tab选中状态同步更新
• 垂直滑动列表区域，RecyclerView可以正常滚动，不会误触发ViewPager2的左右滑动
• 三个Tab页内容完全独立，不会出现RecyclerView悬浮在全局布局的问题

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