ViewPager2切换Fragment时FragmentStateAdapter抛IllegalStateException崩溃求助

ViewPager2底层封装了RecyclerView，RecyclerView的notifyXXX系列更新方法禁止在布局计算、滚动过程中调用，否则就会抛出你遇到的IllegalStateException。你在反向切换Fragment时刚好命中了时间窗口：点击事件触发时ViewPager2内部还在处理布局相关操作，此时调用notifyItemChanged就触发了崩溃，正向切换未崩溃只是刚好没有撞上这个时间窗口，属于概率性问题。

方案1：修复现有实现的调用时机 #

把notifyItemChanged的调用投递到主线程消息队列尾部，等当前所有布局相关任务执行完毕后再触发，从时机上避开布局计算过程。
修改适配器的替换方法：

// 需要先给适配器注入ViewPager2实例，或者从上下文获取对应ViewPager2实例
fun replaceLastFragmentWith(newFragment: Fragment) {
    fragmentList[LAST_FRAGMENT_INDEX] = newFragment
    viewPager2.post {
        // 执行前先判断ViewPager2仍处于挂载状态，避免泄漏或空指针
        if (viewPager2.isAttachedToWindow) {
            notifyItemChanged(LAST_FRAGMENT_INDEX)
        }
    }
}

这个方案改动量最小，不需要调整现有架构逻辑。

方案2（更推荐）：单宿主Fragment管理子Fragment切换 #

直接固定ViewPager2对应页卡的Fragment为宿主Fragment，宿主内部通过childFragmentManager实现两个业务Fragment的切换，完全不需要修改ViewPager2的适配器，从根源上避免和ViewPager2的布局逻辑冲突。
实现步骤：

1. 新建PlaylistHostFragment作为ViewPager2对应页卡的唯一固定Fragment，布局中添加FragmentContainerView作为子Fragment容器。
2. 在宿主Fragment中封装切换逻辑：

class PlaylistHostFragment : Fragment() {
    // 切换到菜单页
    fun switchToMenu() {
        childFragmentManager.commit {
            replace(R.id.fragment_container, PlaylistMenuFragment())
            setReorderingAllowed(true)
        }
    }

    // 切换到内容页
    fun switchToContent() {
        childFragmentManager.commit {
            replace(R.id.fragment_container, PlaylistContentFragment())
            setReorderingAllowed(true)
        }
    }

    // 初始默认展示菜单页
    override fun onViewCreated(view: View, savedInstanceState: Bundle?) {
        super.onViewCreated(view, savedInstanceState)
        if (savedInstanceState == null) {
            switchToMenu()
        }
    }
}

3. 子Fragment需要切换时，获取父Fragment实例调用对应方法即可：

// PlaylistContentFragment内返回菜单的逻辑
fun goToPlaylistMenu() {
    (parentFragment as PlaylistHostFragment).switchToMenu()
}

这个方案的优势：

• 完全和外层ViewPager2逻辑解耦，不存在布局冲突的可能性
• 切换逻辑收拢在宿主内部，后续添加切换动画、保存子Fragment状态都更易实现
• 符合Fragment嵌套使用的官方设计规范

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