Android ViewPager2 createFragment多case触发疑问及直接跳转实现

1. 为什么createFragment的when逻辑会同时触发多个分支 #

这是ViewPager2的完全预期行为，不是代码缺陷。

• 首先澄清一个误区：你写的Kotlin when 不存在分支穿透问题，单次方法调用匹配到对应分支返回后就会终止逻辑，和Java没有加break的switch表现完全不同。
• 你观察到的多分支执行，本质是多次独立的createFragment调用，分别传入了不同的position参数。ViewPager2为了保证滑动切换流畅，默认会提前加载当前选中页相邻1个位置的Fragment（也就是离当前页前后各1页的内容会被提前实例化）。比如当你选中position=1的页面时，系统会依次为position=0、1、2三个位置调用createFragment，自然就会触发这几个分支的日志输出，和when本身的逻辑无关。

2. 直接跳转Fragment3、跳过相邻页面的正确实现方式 #

你目前尝试的“在TabLayout的addOnTabSelectedListener中手动调用setCurrentItem”的写法不符合官方设计规范。

原因：TabLayout和ViewPager2的官方联动本身是通过TabLayoutMediator实现双向状态同步的，手动在Tab选中监听里重复调用setCurrentItem，很容易触发循环回调、Tab选中状态错位的问题，甚至会引发不必要的重复页面创建。

标准实现流程 #

• 完成基础绑定：给ViewPager2设置完FragmentStateAdapter后，通过TabLayoutMediator(tabLayout, viewPager2){ tab, pos -> tab.text = "Tab$pos" }.attach()完成联动，这一步已经自动处理了“选中Tab时同步切换ViewPager页面、滑动ViewPager时同步Tab选中态”的逻辑，不需要手动在Tab监听里做同步操作。
• 直接无动画跳转：如果需要跳过中间页面直接切到目标Fragment，直接调用viewPager2.setCurrentItem(targetPosition, false)即可，第二个参数传false代表关闭滑动切换动画，直接定位到目标页，完全不会经过中间页的滑动流程。
• 关于createFragment的异常问题：这种调用方式完全符合API设计逻辑，不会触发Adapter的异常。createFragment的调用逻辑不会因为setCurrentItem被篡改，它只会按照ViewPager2的预加载规则返回对应位置的Fragment实例。

3. 可调的优化项 #

如果觉得默认的相邻页预加载机制占用过多内存，可以通过修改离屏页面加载限制调整行为：

• 默认值ViewPager2.OFFSCREEN_PAGE_LIMIT_DEFAULT代表保留当前页相邻1页的预加载，保证滑动流畅度。
• 可以根据实际内存情况设置合适的预加载距离，不建议为了减少预加载把值设得过低，否则滑动切换时会出现明显的页面加载白屏。

补充说明：你写的MyPagerAdapter代码本身没有任何逻辑问题，不需要因为多分支触发的现象去修改Adapter内部的when判断逻辑。对应实现参考：

private class MyPagerAdapter(fa: FragmentActivity) : FragmentStateAdapter(fa) {
    override fun createFragment(position: Int): Fragment {
        return when (position) {
            0 -> FragmentOne.newInstance("Fragment 1")
            1 -> FragmentTwo.newInstance("Fragment 2")
            2 -> FragmentThree.newInstance("Fragment 3")
            else -> FragmentOne.newInstance("Fragment 1, Default")
        }
    }
}

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