Android中使用TabLayout时无法启动Activity的问题排查

你遇到的是栈溢出错误，核心原因是EasyFragment的onCreateView方法中递归创建了自身实例，同时你混淆了Navigation Graph和ViewPager2两种Fragment切换的实现逻辑，导致代码冲突。

核心问题点 #

• 无限递归创建Fragment：在EasyFragment的初始化代码里，你创建了包含EasyFragment()的实例列表，这会导致每次创建EasyFragment时，又触发新的EasyFragment实例生成，最终引发栈溢出。
• 实现方式混淆：你同时用了Navigation Graph（用于Fragment跳转）和ViewPager2+TabLayout（用于横向切换Fragment），这两种方式无需同时使用，二选一即可。

修正方案（二选一） #

方案一：ViewPager2+TabLayout管理Fragment（推荐用于Tab切换场景） #

这种方式无需Navigation Graph，直接通过ViewPager2管理三个Fragment的切换逻辑。

1. 修改activity_main.xml，替换为TabLayout+ViewPager2布局：

<?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"
    tools:context=".MainActivity">

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

    <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_constraintBottom_toBottomOf="parent"/>

</androidx.constraintlayout.widget.ConstraintLayout>

2. 更新MainActivity.kt，初始化ViewPager2和TabLayout的关联：

import androidx.appcompat.app.AppCompatActivity
import android.os.Bundle
import androidx.viewpager2.widget.ViewPager2
import com.google.android.material.tabs.TabLayout
import com.google.android.material.tabs.TabLayoutMediator

class MainActivity : AppCompatActivity() {

    private lateinit var viewPager: ViewPager2
    private lateinit var tabLayout: TabLayout

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)

        viewPager = findViewById(R.id.viewPager)
        tabLayout = findViewById(R.id.tabLayout)

        val adapter = ViewPagerAdapter(this)
        viewPager.adapter = adapter

        // 关联Tab和ViewPager，设置Tab标题
        TabLayoutMediator(tabLayout, viewPager) { tab, position ->
            tab.text = when(position) {
                0 -> "Easy"
                1 -> "Medium"
                2 -> "Hard"
                else -> "Easy"
            }
        }.attach()
    }
}

3. 简化ViewPagerAdapter.kt，移除冗余参数：

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

class ViewPagerAdapter(fragmentActivity: FragmentActivity) : FragmentStateAdapter(fragmentActivity) {
    override fun getItemCount(): Int {
        return 3
    }

    override fun createFragment(position: Int): Fragment {
        return when (position) {
            0 -> EasyFragment()
            1 -> MediumFragment()
            2 -> HardFragment()
            else -> EasyFragment()
        }
    }
}

4. 简化EasyFragment.kt（Medium、HardFragment同理）：

import android.os.Bundle
import android.view.LayoutInflater
import android.view.View
import android.view.ViewGroup
import androidx.fragment.app.Fragment

class EasyFragment : Fragment() {
    override fun onCreateView(
        inflater: LayoutInflater, container: ViewGroup?,
        savedInstanceState: Bundle?
    ): View? {
        return inflater.inflate(R.layout.fragment_easy, container, false)
    }
}

5. 删除nav_graph.xml（无需Navigation Graph）。

方案二：Navigation Graph+TabLayout实现跳转 #

通过NavController处理Tab点击后的Fragment跳转逻辑。

1. 修改activity_main.xml，添加TabLayout到布局：

<?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"
    tools:context=".MainActivity">

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

    <androidx.fragment.app.FragmentContainerView
        android:id="@+id/nav_host_fragment"
        android:name="androidx.navigation.fragment.NavHostFragment"
        android:layout_width="match_parent"
        android:layout_height="0dp"
        app:layout_constraintTop_toBottomOf="@id/tabLayout"
        app:defaultNavHost="true"
        app:navGraph="@navigation/nav_graph" />

</androidx.constraintlayout.widget.ConstraintLayout>

2. 更新MainActivity.kt，添加Tab点击跳转逻辑：

import androidx.appcompat.app.AppCompatActivity
import android.os.Bundle
import androidx.navigation.NavController
import androidx.navigation.findNavController
import com.google.android.material.tabs.TabLayout

class MainActivity : AppCompatActivity() {

    private lateinit var navController: NavController

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)

        navController = findNavController(R.id.nav_host_fragment)
        val tabLayout = findViewById<TabLayout>(R.id.tabLayout)

        tabLayout.addTab(tabLayout.newTab().setText("Easy"))
        tabLayout.addTab(tabLayout.newTab().setText("Medium"))
        tabLayout.addTab(tabLayout.newTab().setText("Hard"))

        tabLayout.addOnTabSelectedListener(object : TabLayout.OnTabSelectedListener {
            override fun onTabSelected(tab: TabLayout.Tab?) {
                when(tab?.position) {
                    0 -> navController.navigate(R.id.easyFragment)
                    1 -> navController.navigate(R.id.mediumFragment)
                    2 -> navController.navigate(R.id.hardFragment)
                }
            }

            override fun onTabUnselected(tab: TabLayout.Tab?) {}
            override fun onTabReselected(tab: TabLayout.Tab?) {}
        })
    }

    override fun onSupportNavigateUp(): Boolean {
        return navController.navigateUp() || super.onSupportNavigateUp()
    }
}

3. 修改nav_graph.xml，添加全局跳转Action：

<?xml version="1.0" encoding="utf-8"?>
<navigation 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/nav_graph"
    app:startDestination="@id/easyFragment">

    <fragment
        android:id="@+id/easyFragment"
        android:name="com.example.tablayoutdemo.EasyFragment"
        android:label="fragment_easy"
        tools:layout="@layout/fragment_easy" />

    <fragment
        android:id="@+id/mediumFragment"
        android:name="com.example.tablayoutdemo.MediumFragment"
        android:label="fragment_medium"
        tools:layout="@layout/fragment_medium" />

    <fragment
        android:id="@+id/hardFragment"
        android:name="com.example.tablayoutdemo.HardFragment"
        android:label="fragment_hard"
        tools:layout="@layout/fragment_hard" />

    <action
        android:id="@+id/action_global_to_easy"
        app:destination="@id/easyFragment"/>
    <action
        android:id="@+id/action_global_to_medium"
        app:destination="@id/mediumFragment"/>
    <action
        android:id="@+id/action_global_to_hard"
        app:destination="@id/hardFragment"/>
</navigation>

4. 同样需要简化三个Fragment的代码，移除ViewPager相关逻辑。

总结 #

• 若仅需Tab切换功能，优先选择方案一，它更符合Tab交互的流畅性需求，自带Fragment缓存机制。
• 方案二更适合存在复杂页面跳转逻辑的场景，但Tab切换时会重新创建Fragment（可通过launchSingleTop参数优化）。

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