Activity中ViewPager无法加载Fragment，Fragment事务可正常运行求助

作为Android开发过来的人，我太懂这种ViewPager加载不出来Fragment的抓狂感了！既然你用Fragment事务能正常加载，说明Fragment本身没问题，问题大概率出在ViewPager的配置或Adapter实现上，咱们一步步排查：

1. 先检查ViewPager的Adapter是否正确实现 #

这是ViewPager加载Fragment最容易踩坑的地方，必须确保Adapter继承正确的父类，并且核心方法没有写错：

示例Adapter代码（以Kotlin为例） #

import androidx.fragment.app.Fragment
import androidx.fragment.app.FragmentManager
import androidx.fragment.app.FragmentPagerAdapter

class MainViewPagerAdapter(fm: FragmentManager) : 
    FragmentPagerAdapter(fm, BEHAVIOR_RESUME_ONLY_CURRENT_FRAGMENT) {

    // 必须返回Fragment的总数，这里是4个
    override fun getCount(): Int = 4

    // 根据位置返回对应的Fragment实例
    override fun getItem(position: Int): Fragment {
        return when(position) {
            0 -> UserFragment()
            1 -> RepositoryFragment()
            2 -> FollowersFragment()
            3 -> FollowingFragment()
            else -> UserFragment() // 兜底返回默认Fragment
        }
    }

    // 如果需要和TabLayout配合，重写这个方法返回标签文字
    override fun getPageTitle(position: Int): CharSequence? {
        return when(position) {
            0 -> "用户"
            1 -> "仓库"
            2 -> "关注者"
            3 -> "已关注"
        }
    }
}

注意：如果你用的是Java，逻辑是一样的，只是语法不同；另外要确保导入的是androidx.fragment.app包下的类，不要混用旧的support库。

2. 确保Activity中正确初始化ViewPager并设置Adapter #

很多新手会漏了给ViewPager设置Adapter，或者找错了ViewPager的ID：

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

    // 找到布局中的ViewPager
    val viewPager = findViewById<ViewPager>(R.id.view_pager)
    // 实例化Adapter，传入supportFragmentManager
    val adapter = MainViewPagerAdapter(supportFragmentManager)
    // 关键一步：给ViewPager设置Adapter
    viewPager.adapter = adapter

    // 如果需要和TabLayout联动，加上这段
    val tabLayout = findViewById<TabLayout>(R.id.tab_layout)
    tabLayout.setupWithViewPager(viewPager)
}

3. 检查ViewPager的布局配置 #

如果ViewPager的宽高设置不对，即使逻辑正确也会看不到Fragment：

<!-- 布局文件中的ViewPager示例 -->
<androidx.viewpager.widget.ViewPager
    android:id="@+id/view_pager"
    android:layout_width="match_parent"
    android:layout_height="match_parent" />

避免设置wrap_content（ViewPager默认不支持wrap_content，需要自定义或固定高度），也不要把宽高设为0dp除非有约束布局配合。

4. 排查Fragment自身的生命周期问题 #

虽然你用事务能加载，但还是可以在Fragment的生命周期方法里加日志，确认ViewPager是否真的创建了Fragment：

class UserFragment : Fragment() {
    override fun onCreateView(inflater: LayoutInflater, container: ViewGroup?, savedInstanceState: Bundle?): View? {
        Log.d("UserFragment", "onCreateView 被调用了！")
        return inflater.inflate(R.layout.fragment_user, container, false)
    }
}

如果日志没打印，说明Adapter或ViewPager的初始化有问题；如果打印了但看不到界面，可能是Fragment的布局有问题。

5. 避免混用AndroidX和旧Support库 #

这是隐形坑！确保你的项目中所有Fragment、ViewPager、FragmentManager都是androidx包下的，不要同时导入android.support.v4.app的类，否则会出现类兼容异常。

按上面的步骤排查，大概率能解决问题——毕竟Fragment事务能正常工作，说明Fragment本身没问题，问题肯定出在ViewPager的配置环节。

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