ViewPager2使用FragmentStateAdapter动态添加Fragment未attach上下文报错如何解决

问题根因 #

notifyItemInserted 触发的ViewPager2布局更新、Fragment创建流程是异步的，会被投递到主线程消息队列末尾，等当前onViewCreated代码块全部执行完成后才会运行。所以你紧跟在notifyItemInserted后的代码执行时，PageFragment还没被Adapter创建、也没有绑定上下文，必然会抛出未attach的异常。

可行解决方案 #

所有方案均满足在HostFragment中完成View加载的业务需求：

方案1：监听子Fragment生命周期（最稳定，无兼容性问题）

通过HostFragment的childFragmentManager注册子Fragment生命周期回调，监听到目标PageFragment绑定上下文后再执行View操作，用完后主动移除回调避免内存泄漏：

viewModel.pages.add(PageFragment())
val newItemPosition = viewModel.pages.size - 1
viewPagerAdapter.notifyItemInserted(newItemPosition)

childFragmentManager.registerFragmentLifecycleCallbacks(object : FragmentManager.FragmentLifecycleCallbacks() {
    override fun onFragmentAttached(fm: FragmentManager, f: Fragment, context: Context) {
        super.onFragmentAttached(fm, f, context)
        // 匹配到刚添加的目标PageFragment再执行逻辑
        if (f is PageFragment && f == viewModel.pages.last()) {
            val inflater = LayoutInflater.from(context).inflate(R.layout.some_view, null, false)
            f.binding.addView(inflater)
            // 移除回调避免内存泄漏
            childFragmentManager.unregisterFragmentLifecycleCallbacks(this)
        }
    }
}, false)

方案2：Post到主线程队列尾部（轻量快捷，适合简单场景）

把View操作逻辑post到主线程消息队列，优先级低于ViewPager2的布局更新任务，会等Fragment创建完成后再执行：

viewModel.pages.add(PageFragment())
val newItemPosition = viewModel.pages.size - 1
viewPagerAdapter.notifyItemInserted(newItemPosition)

requireView().post {
    val page = viewModel.pages.last()
    val inflater = LayoutInflater.from(page.requireContext()).inflate(R.layout.some_view, null, false)
    page.binding.addView(inflater)
}

方案3：配合ViewPager2页面切换回调（适合新增后跳转到新页的场景）

如果新增Fragment后需要切到对应页面，可通过页面选中回调触发操作：

viewModel.pages.add(PageFragment())
val newItemPosition = viewModel.pages.size - 1
viewPagerAdapter.notifyItemInserted(newItemPosition)

viewPager.registerOnPageChangeCallback(object : ViewPager2.OnPageChangeCallback() {
    override fun onPageSelected(position: Int) {
        super.onPageSelected(position)
        if (position == newItemPosition) {
            val page = viewModel.pages.last()
            val inflater = LayoutInflater.from(page.requireContext()).inflate(R.layout.some_view, null, false)
            page.binding.addView(inflater)
            // 移除回调避免内存泄漏
            viewPager.unregisterOnPageChangeCallback(this)
        }
    }
})
// 切到新增的页面
viewPager.setCurrentItem(newItemPosition, true)

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