Android开发：TabLayout无法转换为ViewPager2异常求助

问题根源 #

从错误日志的核心报错java.lang.ClassCastException: com.google.android.material.tabs.TabLayout cannot be cast to androidx.viewpager2.widget.ViewPager2可以看出：你在初始化ViewPager2时，错误地使用了TabLayout的ID进行查找，导致类型强制转换失败。

查看你的TabLayoutFragment代码，这里是错误的核心：

tabLayout = (TabLayout) root.findViewById(R.id.tab_layout);
viewPager2 = (ViewPager2) root.findViewById(R.id.tab_layout); // 此处使用了TabLayout的ID！

而你的XML布局中，ViewPager2的实际ID是view_pager，两者ID不匹配导致类型转换错误。

修复步骤 #

1. 修正ViewPager2的初始化ID #

将TabLayoutFragment中ViewPager2的查找代码，把R.id.tab_layout替换为R.id.view_pager：

viewPager2 = (ViewPager2) root.findViewById(R.id.view_pager);

2. （可选）使用官方工具简化Tab与ViewPager2的关联 #

Google提供了TabLayoutMediator工具类，可以自动完成TabLayout和ViewPager2的双向同步（Tab切换→ViewPager跳转、ViewPager滑动→Tab选中），无需手动编写监听逻辑，代码更简洁不易出错。

修改TabLayoutFragment的onCreateView方法，替换原有的手动监听代码：

// 移除原来的addOnTabSelectedListener和registerOnPageChangeCallback代码
new TabLayoutMediator(tabLayout, viewPager2, (tab, position) -> {
    // 动态设置Tab标题
    switch(position) {
        case 0: tab.setText("Alpha"); break;
        case 1: tab.setText("Beta"); break;
        case 2: tab.setText("Charlie"); break;
        case 3: tab.setText("Delta"); break;
    }
}).attach();

注意需要导入类：com.google.android.material.tabs.TabLayoutMediator。

修复后的完整TabLayoutFragment代码 #

package com.ssl.app.ui.tablayout;

import android.os.Bundle;
import android.view.LayoutInflater;
import android.view.View;
import android.view.ViewGroup;

import androidx.annotation.NonNull;
import androidx.annotation.Nullable;
import androidx.fragment.app.Fragment;
import androidx.viewpager2.widget.ViewPager2;

import com.google.android.material.tabs.TabLayout;
import com.google.android.material.tabs.TabLayoutMediator;
import com.ssl.app.R;

public class TabLayoutFragment extends Fragment {

    TabLayout tabLayout;
    ViewPager2 viewPager2;
    MyViewPagerAdapter myViewPagerAdapter;

    @Nullable
    @Override
    public View onCreateView(@NonNull LayoutInflater inflater, @Nullable ViewGroup container, @Nullable Bundle savedInstanceState) {
        View root = inflater.inflate(R.layout.fragment_tablayout,container,false);

        tabLayout = root.findViewById(R.id.tab_layout);
        viewPager2 = root.findViewById(R.id.view_pager);

        myViewPagerAdapter = new MyViewPagerAdapter(this);
        viewPager2.setAdapter(myViewPagerAdapter);

        // 自动关联TabLayout与ViewPager2
        new TabLayoutMediator(tabLayout, viewPager2, (tab, position) -> {
            switch(position) {
                case 0:
                    tab.setText("Alpha");
                    break;
                case 1:
                    tab.setText("Beta");
                    break;
                case 2:
                    tab.setText("Charlie");
                    break;
                case 3:
                    tab.setText("Delta");
                    break;
            }
        }).attach();

        return root;
    }
}

内容的提问来源于stack exchange，提问作者Wabi-Sabi