Android BottomNavigationView动态切换菜单遇上限报错解决方案问询

问题1：动态添加第五个底部导航菜单项的解决方案 #

你遇到的超限异常是因为重复添加菜单项导致的：Activity重建或登录状态多次变化时，你没有移除旧的「个人页」菜单项，直接新增就会导致总菜单项数超过BottomNavigationView的5项上限。
优化后的动态添加逻辑如下：

private fun updateProfileMenuItem() {
    val menu = binding.bottomNavigationView.menu
    // 先移除两种状态的个人页菜单项，避免重复添加
    menu.removeItem(R.id.userLoggedInFragment)
    menu.removeItem(R.id.userLoggedOutFragment)
    
    // 解释Menu.add的四个参数：(组ID, 菜单项ID, 排序优先级, 显示标题)
    // 传Menu.NONE代表使用默认配置：不分组、按添加顺序排序
    if(user.isLoggedIn) {
        menu.add(Menu.NONE, R.id.userLoggedInFragment, Menu.NONE, "我的")
            .setIcon(R.drawable.child_selector_profil)
    } else {
        menu.add(Menu.NONE, R.id.userLoggedOutFragment, Menu.NONE, "我的")
            .setIcon(R.drawable.child_selector_profil)
    }
}

同时需要在Activity初始化时先恢复导航状态再更新菜单，避免选中状态丢失：

override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    binding = ActivityMainBinding.inflate(layoutInflater)
    setContentView(binding.root)
    
    val navController = findNavController(R.id.fragment_container)
    // 先绑定导航控制器，此时已自动恢复Activity重建前的页面状态
    binding.bottomNavigationView.setupWithNavController(navController)
    // 更新个人页菜单项
    updateProfileMenuItem()
    // 同步选中状态，避免重建后默认选中首页
    binding.bottomNavigationView.selectedItemId = navController.currentDestination?.id ?: R.id.homeFragment

    // 监听登录状态变化，实时更新菜单
    viewModel.loginState.observe(this) {
        updateProfileMenuItem()
        // 可选：如果当前停留在个人页，登录状态变化后自动切换到对应页面
        val currentDestId = navController.currentDestination?.id
        if (currentDestId == R.id.userLoggedOutFragment && user.isLoggedIn) {
            navController.navigate(R.id.userLoggedInFragment)
        } else if (currentDestId == R.id.userLoggedInFragment && !user.isLoggedIn) {
            navController.navigate(R.id.userLoggedOutFragment)
        }
    }
}

问题2：动态修改菜单跳转逻辑的解决方案 #

因为你已经把BottomNavigationView和NavController做了绑定，只要保证菜单项的ID和导航图中对应Fragment的ID一致，系统会自动完成跳转匹配，不需要额外写点击事件：

• 未登录状态下添加的菜单项ID是R.id.userLoggedOutFragment，点击就会自动跳转到未登录个人页
• 登录状态下添加的菜单项ID是R.id.userLoggedInFragment，点击就会自动跳转到登录后个人页

可选优化：原有双菜单切换方案修复 #

如果你不想用动态添加的方式，原来的切换两套菜单的方案也可以通过保存选中状态修复问题：

private fun setUpBottomNav(newMenu: Int) {
    with(binding.bottomNavigationView) {
        // 切换前先保存当前选中的菜单项ID
        val selectedItemId = selectedItemId
        menu.clear()
        inflateMenu(newMenu)
        setupWithNavController(findNavController(R.id.fragment_container))
        // 恢复选中状态：如果原选中项在新菜单中存在就直接恢复，否则选中对应状态的个人页
        if (menu.findItem(selectedItemId) != null) {
            setSelectedItemId(selectedItemId)
        } else {
            setSelectedItemId(if(user.isLoggedIn) R.id.userLoggedInFragment else R.id.userLoggedOutFragment)
        }
        setOnItemReselectedListener {}
    }
}

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