Android中TabLayout搭配ViewPager2点击切换Fragment失效问题求助

我在Android应用中使用TabLayout搭配ViewPager2时遇到问题：ViewPager2的滑动功能正常，但点击TabLayout的标签无法切换对应Fragment。

我已按Android官方文档的建议完成集成：每个标签对应一个Fragment，用自定义PagerAdapter填充ViewPager2，通过TabLayoutMediator关联TabLayout与ViewPager2，但点击标签仅响应触摸滚动，无法切换Fragment。我已确认以下内容：

• 布局XML中TabLayout和ViewPager2初始化正确
• PagerAdapter配置正确，可正常填充Fragment
• 已使用TabLayoutMediator建立两者关联

问题演示 #

布局XML代码 #

<?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:id="@+id/main"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    tools:context=".MainActivity">

    <com.google.android.material.tabs.TabLayout
        android:id="@+id/tabLayout"
        android:layout_width="0dp"
        android:layout_height="wrap_content"
        app:layout_constraintEnd_toEndOf="parent"
        app:layout_constraintStart_toStartOf="parent"
        app:layout_constraintTop_toTopOf="@+id/viewPager2" />

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

</androidx.constraintlayout.widget.ConstraintLayout>

MainActivity代码 #

import android.os.Bundle
import androidx.activity.enableEdgeToEdge
import androidx.appcompat.app.AppCompatActivity
import androidx.core.view.ViewCompat
import androidx.core.view.WindowInsetsCompat
import androidx.viewpager2.widget.ViewPager2
import com.alzibdehsoftware.viewpager.databinding.ActivityMainBinding
import com.google.android.material.tabs.TabLayout
import com.google.android.material.tabs.TabLayout.Tab
import com.google.android.material.tabs.TabLayoutMediator

class MainActivity : AppCompatActivity() {
    lateinit var binding: ActivityMainBinding
    lateinit var pager: ViewPager2
    lateinit var adapter: MyPagerAdapter
    var tabTitles = arrayOf("First","Second","Third")
    var fragmentList = listOf(FirstFragment(),SecondFragment(),ThirdFragment())
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        binding = ActivityMainBinding.inflate(layoutInflater)
        setContentView(binding.root)
        initViewPager()
        initTabLayout()
        }

    private fun initTabLayout() {
        TabLayoutMediator(binding.tabLayout, pager) { tab, position ->
            tab.text = tabTitles[position]
        }.attach()
    }

    private fun initViewPager() {
         pager = findViewById<ViewPager2>(R.id.viewPager2)
        adapter= MyPagerAdapter(this,fragmentList)
        pager.adapter=adapter
    }
}

MyPagerAdapter代码 #

package com.alzibdehsoftware.viewpager

import androidx.fragment.app.Fragment
import androidx.fragment.app.FragmentActivity
import androidx.viewpager2.adapter.FragmentStateAdapter

class MyPagerAdapter(val container: FragmentActivity, val fragmentList: List<Fragment>): FragmentStateAdapter(container) {
    override fun getItemCount(): Int {
        return fragmentList.size
    }

    override fun createFragment(position: Int): Fragment {
        return fragmentList[position]
    }
}

问题原因及解决方法 #

问题出在布局层级与约束上：ViewPager2的布局覆盖了TabLayout，导致TabLayout的点击事件被ViewPager2拦截。XML中后定义的View层级更高，ViewPager2在TabLayout之后定义，且TabLayout的顶部约束绑定到ViewPager2，造成布局重叠，点击TabLayout时实际触发的是下方ViewPager2的滚动事件。

解决步骤：

1. 调整布局顺序，将TabLayout放在ViewPager2之后，提升TabLayout的层级；
2. 修改TabLayout的顶部约束为对齐父布局，同时让ViewPager2的顶部约束绑定到TabLayout的底部，避免重叠。

修改后的布局XML：

<?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:id="@+id/main"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    tools:context=".MainActivity">

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

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

</androidx.constraintlayout.widget.ConstraintLayout>

另外，MainActivity中已使用ViewBinding，可简化initViewPager的代码：

private fun initViewPager() {
    pager = binding.viewPager2
    adapter = MyPagerAdapter(this, fragmentList)
    pager.adapter = adapter
}

修改后TabLayout的点击事件即可正常触发，实现Fragment切换。

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