Android Studio导航抽屉活动添加TabLayout崩溃及XML渲染问题求助

咱们先直接看报错信息：Only TabItem instances can be added to TabLayout，这个提示已经把问题说得明明白白——你在XML布局的TabLayout里面直接添加了非TabItem类型的子View（比如LinearLayout、TextView之类的），这是TabLayout不允许的，也是导致XML渲染失败、运行时崩溃的核心原因。

接下来咱们一步步解决问题：

1. 先修正XML布局的错误 #

TabLayout的子元素只能是TabItem，不能直接放其他自定义View，正确的基础写法应该是这样：

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

    <!-- 只能添加TabItem，不能塞其他View进来 -->
    <com.google.android.material.tabs.TabItem
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="试卷列表"/>

    <com.google.android.material.tabs.TabItem
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="已做试卷"/>
</com.google.android.material.tabs.TabLayout>

如果需要自定义Tab的样式（比如加图标、调整文字样式），不能直接把自定义布局塞到TabLayout里，要通过代码动态设置：

• 先在XML里只保留空的TabLayout：

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

• 然后在Activity里加载自定义布局并设置给Tab：

  TabLayout tabLayout = findViewById(R.id.tabLayout);
  
  // 第一个Tab：加载自定义布局
  TabLayout.Tab tab1 = tabLayout.newTab();
  View customTab1 = LayoutInflater.from(this).inflate(R.layout.custom_tab, null);
  tab1.setCustomView(customTab1);
  tabLayout.addTab(tab1);
  
  // 第二个Tab：直接用布局ID设置
  TabLayout.Tab tab2 = tabLayout.newTab();
  tab2.setCustomView(R.layout.custom_tab_2);
  tabLayout.addTab(tab2);
  

2. 确认Navigation Drawer的布局结构合理性 #

TabLayout通常要放在AppBarLayout内部、Toolbar下方，配合ViewPager实现页面切换，完整的布局片段参考：

<androidx.coordinatorlayout.widget.CoordinatorLayout
    android:layout_width="match_parent"
    android:layout_height="match_parent">

    <com.google.android.material.appbar.AppBarLayout
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:theme="@style/Theme.YourApp.AppBarOverlay">

        <androidx.appcompat.widget.Toolbar
            android:id="@+id/toolbar"
            android:layout_width="match_parent"
            android:layout_height="?attr/actionBarSize"
            android:background="?attr/colorPrimary"
            app:popupTheme="@style/Theme.YourApp.PopupOverlay"/>

        <!-- TabLayout放在Toolbar下方，属于AppBar的一部分 -->
        <com.google.android.material.tabs.TabLayout
            android:id="@+id/tabLayout"
            android:layout_width="match_parent"
            android:layout_height="wrap_content"
            app:tabMode="fixed"/>

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

    <!-- ViewPager用来承载Tab对应的页面，要设置滚动行为 -->
    <androidx.viewpager.widget.ViewPager
        android:id="@+id/viewPager"
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        app:layout_behavior="@string/appbar_scrolling_view_behavior"/>

    <!-- 导航抽屉的NavigationView -->
    <com.google.android.material.navigation.NavigationView
        android:id="@+id/nav_view"
        android:layout_width="wrap_content"
        android:layout_height="match_parent"
        android:layout_gravity="start"
        android:fitsSystemWindows="true"
        app:headerLayout="@layout/nav_header_main"
        app:menu="@menu/activity_main_drawer"/>

</androidx.coordinatorlayout.widget.CoordinatorLayout>

3. 完善Activity代码的逻辑 #

你的QuestionPaperActivity已经实现了NavigationView.OnNavigationItemSelectedListener，记得要绑定监听，同时如果用ViewPager的话，要完成Tab和ViewPager的联动：

public class QuestionPaperActivity extends AppCompatActivity implements NavigationView.OnNavigationItemSelectedListener {

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_question_paper);
        
        // 设置Toolbar
        Toolbar toolbar = findViewById(R.id.toolbar);
        setSupportActionBar(toolbar);

        // 绑定导航抽屉的选中监听
        NavigationView navigationView = findViewById(R.id.nav_view);
        navigationView.setNavigationItemSelectedListener(this);

        // 关联TabLayout和ViewPager
        ViewPager viewPager = findViewById(R.id.viewPager);
        TabLayout tabLayout = findViewById(R.id.tabLayout);

        // 设置ViewPager适配器
        PaperPagerAdapter adapter = new PaperPagerAdapter(getSupportFragmentManager());
        adapter.addFragment(new PaperListFragment(), "试卷列表");
        adapter.addFragment(new DonePaperFragment(), "已做试卷");
        viewPager.setAdapter(adapter);

        // 让TabLayout和ViewPager联动
        tabLayout.setupWithViewPager(viewPager);
    }

    // 实现导航抽屉的点击事件处理
    @Override
    public boolean onNavigationItemSelected(@NonNull MenuItem item) {
        // 根据点击的菜单项处理逻辑
        int id = item.getItemId();
        if (id == R.id.nav_home) {
            // 跳转到首页
            startActivity(new Intent(this, MainActivity.class));
        } else if (id == R.id.nav_settings) {
            // 跳转到设置页面
            startActivity(new Intent(this, SettingsActivity.class));
        }

        // 关闭导航抽屉
        DrawerLayout drawer = findViewById(R.id.drawer_layout);
        drawer.closeDrawer(GravityCompat.START);
        return true;
    }

    // 自定义ViewPager适配器
    private static class PaperPagerAdapter extends FragmentPagerAdapter {
        private final List<Fragment> fragmentList = new ArrayList<>();
        private final List<String> titleList = new ArrayList<>();

        public PaperPagerAdapter(FragmentManager fm) {
            super(fm);
        }

        public void addFragment(Fragment fragment, String title) {
            fragmentList.add(fragment);
            titleList.add(title);
        }

        @NonNull
        @Override
        public Fragment getItem(int position) {
            return fragmentList.get(position);
        }

        @Override
        public int getCount() {
            return fragmentList.size();
        }

        @Nullable
        @Override
        public CharSequence getPageTitle(int position) {
            return titleList.get(position);
        }
    }
}

按照上面的步骤调整后，XML渲染的问题会先解决，运行时的崩溃也会消失，同时TabLayout和导航抽屉的功能都能正常工作。

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