使用FragmentPagerAdapter时，切换页面残留不可见Fragment菜单的问题求助

问题原因 #

FragmentPagerAdapter默认会缓存1个相邻Fragment（offscreenPageLimit=1），这些缓存的Fragment仍处于RESUMED生命周期状态，导致它们注册的MenuProvider未被自动移除。手动调用setCurrentItem或通过PageChangeListener切换页面时，不会触发缓存Fragment的生命周期降级，因此旧Fragment的菜单会和当前Fragment的菜单叠加显示。

解决方案 #

利用Fragment的setMenuVisibility方法（该方法会在Fragment对用户可见/不可见时被调用，不受缓存影响），手动管理MenuProvider的注册与移除：

1. 在Fragment中保存MenuProvider引用 #

在Fragment内部定义MenuProvider成员变量，避免重复创建实例：

private var fragmentMenuProvider: MenuProvider? = null
private val menuRes: Int = R.id.your_fragment_menu // 替换为你的菜单资源ID
private val menuCallback: (Int) -> Boolean = { menuItemId ->
    // 处理菜单点击逻辑
    when(menuItemId) {
        R.id.action_example -> {
            // 执行对应操作
            true
        }
        else -> false
    }
}

2. 实现MenuProvider的注册与移除逻辑 #

添加两个方法分别处理注册和移除操作：

private fun registerMenuProvider() {
    fragmentMenuProvider?.let { return } // 避免重复注册
    fragmentMenuProvider = object : MenuProvider {
        override fun onCreateMenu(menu: Menu, menuInflater: MenuInflater) {
            menuInflater.inflate(menuRes, menu)
        }

        override fun onMenuItemSelected(menuItem: MenuItem): Boolean {
            return menuCallback(menuItem.itemId)
        }
    }
    (requireActivity() as MenuHost).addMenuProvider(
        fragmentMenuProvider!!,
        viewLifecycleOwner,
        Lifecycle.State.RESUMED
    )
}

private fun unregisterMenuProvider() {
    fragmentMenuProvider?.let {
        (requireActivity() as MenuHost).removeMenuProvider(it)
        fragmentMenuProvider = null
    }
}

3. 重写setMenuVisibility控制菜单显示 #

在Fragment中重写setMenuVisibility，根据可见状态触发注册/移除：

override fun setMenuVisibility(visible: Boolean) {
    super.setMenuVisibility(visible)
    if (view != null) { // 确保View已创建完成
        if (visible) {
            registerMenuProvider()
        } else {
            unregisterMenuProvider()
        }
    }
}

4. 补充生命周期清理 #

在Fragment的onDestroyView中移除MenuProvider，避免内存泄漏：

override fun onDestroyView() {
    unregisterMenuProvider()
    super.onDestroyView()
}

额外说明 #

• Activity级别的全局MenuProvider无需修改，它会始终生效并与当前Fragment的菜单叠加显示（符合需求）。
• 该方案无需修改offscreenPageLimit，不会影响ViewPager的缓存性能。

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