FragmentStateAdapter搭配ViewPager2加载Fragment比旧版组件延迟问题求助

核心根因 #

你遇到的滑动延迟本质是FragmentStateAdapter和旧版FragmentStatePagerAdapter的默认生命周期管理策略不同：

• 旧版FragmentStatePagerAdapter默认使用BEHAVIOR_SET_USER_VISIBLE_HINT模式，会提前将相邻缓存页的Fragment唤醒到onResume状态，所有页面加载逻辑会在滑动前执行完成
• 新版FragmentStateAdapter强制使用BEHAVIOR_RESUME_ONLY_CURRENT_FRAGMENT模式，仅当前可见的Fragment会走到onResume生命周期，若你将数据加载、视图渲染等逻辑放在onResume中，滑动切换时才会触发执行，自然会出现明显延迟

修复步骤 #

1. 调整Fragment加载逻辑时机
   将EmployeeSummaryFragment中无需页面可见就可以执行的布局初始化、数据拉取逻辑从onResume迁移到onCreateView中，缓存页创建时就会提前执行，滑动时直接渲染已加载好的视图，无额外延迟。

2. 优化ViewPager2缓存配置
   ViewPager2底层基于RecyclerView实现，除了offscreenPageLimit缓存Fragment实例外，还可以增加底层View缓存，进一步提升滑动流畅度：

viewPager2.apply {
    offscreenPageLimit = 2 // 缓存前后各2个页面，可根据业务调整
    // 开启底层View缓存
    (getChildAt(0) as RecyclerView).apply {
        setItemViewCacheSize(3)
        isNestedScrollingEnabled = false // 如果没有嵌套滚动需求可以关闭，减少性能消耗
    }
}

3. 删除不必要的性能损耗代码

• 删除viewPager2!!.id = (System.currentTimeMillis() % 100000).toInt()这行代码：动态修改View id会导致系统视图状态保存/恢复异常，完全无必要
• 删除Handler(Looper.getMainLooper()).postDelayed({setupFragment()}, 0)：延迟0ms执行不会提升性能，反而会拖慢首次页面初始化速度，直接在onCreateView中调用setupFragment()即可

4. 移除Adapter中不必要的Fragment缓存
   你在EmployeeSummaryAdapter中用SparseArray存Fragment实例的行为会导致内存泄漏，FragmentStateAdapter会自行管理Fragment的生命周期，无需手动持有引用。如果需要获取指定位置的Fragment，可通过FragmentManager按规则查找即可。

调整完成后滑动流畅度会和旧版ViewPager完全一致。

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