Android BottomNavigation页面切换时选中项未高亮解决方法

• 实现BottomNavigation组件后，直接点击home、cart等底部导航项，基础跳转逻辑运行正常
• 从home页内导航到子页面AllCategoriesFragment时，首次进入底部导航默认高亮home项，表现符合预期
• 异常表现：先切换到cart页面，再点击home返回AllCategoriesFragment时，页面跳转逻辑正常，但底部导航仍保持cart项高亮，未同步选中home项

手动设置选中项的核心方法 #

直接调用BottomNavigationView的selectedItemId属性（对应Java的setSelectedItemId()方法），即可手动控制底部导航的高亮状态，传入对应tab在menu文件中配置的id即可：

// 获取BottomNavigation实例
val bottomNav = findViewById<BottomNavigationView>(R.id.bottom_nav)
// 主动设置home项为选中高亮状态
bottomNav.selectedItemId = R.id.nav_home

注意：不要在底部导航的item选中回调中直接调用该方法，否则会触发重复跳转、栈溢出问题。

配合Navigation组件使用的完整修复 #

如果是通过Android Jetpack Navigation组件绑定底部导航，出现状态不同步是因为tab内部嵌套导航的返回栈没有和底部选中状态联动，按以下步骤配置即可：

1. 确保正确完成导航组件和底部导航的绑定

val navController = findNavController(R.id.nav_host_fragment_content_main)
findViewById<BottomNavigationView>(R.id.bottom_nav).setupWithNavController(navController)

2. 给导航控制器加目的地变化监听，只要当前页面属于某个tab的导航子节点，就主动同步底部选中状态：

navController.addOnDestinationChangedListener { _, destination, _ ->
    val bottomNav = findViewById<BottomNavigationView>(R.id.bottom_nav)
    when (destination.id) {
        // home tab下所有页面，包括主home页、AllCategoriesFragment等子页面
        R.id.homeFragment, R.id.allCategoriesFragment -> {
            if (bottomNav.selectedItemId != R.id.nav_home) {
                // 临时解绑选中监听，避免触发不必要的fragment重建
                bottomNav.setOnItemSelectedListener(null)
                bottomNav.selectedItemId = R.id.nav_home
                // 重新绑定监听
                bottomNav.setupWithNavController(navController)
            }
        }
        // cart、profile等其他tab同理，把对应tab下的所有页面id列入分支即可
        R.id.cartFragment -> {
            if (bottomNav.selectedItemId != R.id.nav_cart) {
                bottomNav.setOnItemSelectedListener(null)
                bottomNav.selectedItemId = R.id.nav_cart
                bottomNav.setupWithNavController(navController)
            }
        }
    }
}

常见踩坑提醒 #

• 不要使用bottomNav.menu.findItem(R.id.nav_home).isChecked = true单独修改menu项状态，该方法只会修改数据层状态，不会触发底部导航的UI重绘，会出现数据和UI展示不一致的问题
• 处理返回栈逻辑（比如用户按系统返回键回到上一个tab的子页面）时，同样会触发目的地变化回调，上述监听逻辑可以自动覆盖这类场景，不需要额外处理

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