ViewPager2中Fragment如何正确加载ActionBar菜单

算力阿峰

2026-8-29

问题根源

你遇到的首屏菜单错乱、菜单项累加问题，核心原因有三点：

设置offscreenPageLimit = 2后，ViewPager2初始化阶段会预加载当前页相邻的Fragment，所有预加载Fragment都会触发生命周期回调，原生的onCreateOptionsMenu会按加载顺序依次执行，最后一个完成加载的Fragment注入的菜单会覆盖首屏本该显示的内容，这就是首次启动首屏菜单错位的直接原因。
基于setHasOptionsMenu(true)的传统菜单分发逻辑，会给所有已创建的Fragment分发菜单创建事件，不会自动清理其他Fragment注入的菜单项，自然会出现菜单项不断累加的问题。
原生菜单创建的触发时机和Fragment的resume状态不绑定，预加载的Fragment即使不在当前可见页面，也会参与菜单注入，所以你想在onResume里触发菜单加载的思路，用原生方案是走不通的。

适配方案（全局Toolbar实现）

直接放弃原生Fragment OptionsMenu分发机制，通过ViewPager2的选中回调主动控制Toolbar的菜单、标题更新，全程复用Activity上的全局Toolbar，不会有切换割裂感，按以下步骤操作：

先清空所有Fragment里和OptionsMenu相关的代码：删掉setHasOptionsMenu(true)、onCreateOptionsMenu、onOptionsItemSelected的覆写，避免和后续主动控制逻辑冲突。
在宿主Activity中给ViewPager2注册页面变化回调，每次切页时主动更新Toolbar状态，同时在首次加载完成后主动触发一次首屏的Toolbar初始化，避免预加载覆盖首屏内容：

// 宿主Activity内代码
val pagerAdapter = ViewPagerAdapter()
viewPager2.apply {
    offscreenPageLimit = 2
    adapter = pagerAdapter
    registerOnPageChangeCallback(object : ViewPager2.OnPageChangeCallback() {
        override fun onPageSelected(position: Int) {
            super.onPageSelected(position)
            updateToolbarForPosition(position)
        }
    })
}
// 等ViewPager2完成预加载后，初始化首屏Toolbar状态
viewPager2.post {
    updateToolbarForPosition(viewPager2.currentItem)
}

实现updateToolbarForPosition方法，核心逻辑是每次更新前先清空旧菜单，再加载当前页对应的配置：

private fun updateToolbarForPosition(position: Int) {
    // 替换成你自己布局中的Toolbar实例
    val toolbar: Toolbar = binding.toolbar
    // 清空旧菜单，从根源解决菜单项累加问题
    toolbar.menu.clear()
    // 获取当前选中的Fragment实例
    val currentFragment = supportFragmentManager.findFragmentByTag("f$position") ?: return
    // 如果Fragment实现了Toolbar配置接口，直接读配置即可，不需要硬写position判断
    if (currentFragment is ToolbarConfigProvider) {
        // 设置标题
        toolbar.title = currentFragment.getToolbarTitle()
        // 加载对应菜单
        val menuRes = currentFragment.getMenuRes()
        if (menuRes != 0) {
            toolbar.inflateMenu(menuRes)
        }
        // 绑定菜单点击事件
        toolbar.setOnMenuItemClickListener { item ->
            currentFragment.onMenuItemClick(item.itemId)
        }
    }
}

定义统一的Toolbar配置接口，让每个Fragment自己管理自己的标题、菜单资源、点击逻辑，避免把所有业务逻辑堆在Activity里：

interface ToolbarConfigProvider {
    fun getToolbarTitle(): String
    fun getMenuRes(): Int
    fun onMenuItemClick(itemId: Int): Boolean
}

每个需要配置Toolbar的Fragment实现这个接口即可，比如你之前的带新增按钮的Fragment：

class GenericFragment : Fragment(), ToolbarConfigProvider {
    // 其他原有业务逻辑保留，不需要再写OptionsMenu相关代码
    private var _binding: FragmentGenericBinding? = null
    private val binding get() = _binding!!

    override fun onCreateView(
        inflater: LayoutInflater,
        container: ViewGroup?,
        savedInstanceState: Bundle?
    ): View {
        _binding = FragmentGenericBinding.inflate(inflater, container, false)
        return binding.root
    }

    override fun getToolbarTitle(): String = "Menú"

    override fun getMenuRes(): Int = R.menu.menu_add

    override fun onMenuItemClick(itemId: Int): Boolean {
        return when (itemId) {
            R.id.menu_add -> {
                FragmentAddMenu().show(parentFragmentManager, "Add Menu")
                true
            }
            else -> false
        }
    }

    override fun onDestroyView() {
        super.onDestroyView()
        _binding = null
    }
}

方案说明

完全绕开了原生菜单分发的预加载干扰，只有页面被真正选中时才会更新Toolbar，不会出现预加载Fragment覆盖首屏菜单的问题。
每次更新前主动清空菜单，彻底解决菜单项累加问题。
全程复用Activity上绑定的全局Toolbar，切换页面时没有Toolbar整体替换的动画割裂感，符合视觉要求。
首次加载通过post触发初始化，会等ViewPager2预加载流程走完后再执行，保证首屏显示的是当前选中页的正确标题和菜单。

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