Android BottomNavigation导航失效：修改ID后菜单无法正常工作

问题原因 #

Android Jetpack Navigation的NavigationUI.setupWithNavController默认通过菜单项ID与导航图中目的地（Fragment）ID完全匹配来实现点击跳转。你修改菜单项ID后，菜单项ID（menu_home/menu_dashboard/menu_health）和导航图里的Fragment ID（fragment_home/fragment_dashboard/fragment_health）不再对应，导致点击菜单项无法找到对应的页面，导航失效。

排查步骤 #

• 对比菜单XML中的android:id和导航图XML中Fragment的android:id，确认两者是否一致
• 检查NavigationUI.setupWithNavController是否正确关联了BottomNavigationView和NavController
• 确认导航图已正确绑定到NavHostFragment（你的代码中app:navGraph="@navigation/mobile_navigation"配置正确）

解决方法 #

方案1：统一菜单项与目的地ID（推荐） #

直接修改菜单XML中的item ID，使其与导航图里的Fragment ID完全一致：

<!-- 修改后的 bottom_nav_menu.xml -->
<?xml version="1.0" encoding="utf-8"?>
<menu xmlns:android="http://schemas.android.com/apk/res/android">

    <item
        android:id="@+id/fragment_home"
        android:icon="@drawable/ic_home_black_24dp"
        android:title="@string/title_home" />

    <item
        android:id="@+id/fragment_dashboard"
        android:icon="@drawable/ic_dashboard_black_24dp"
        android:title="@string/title_dashboard" />

    <item
        android:id="@+id/fragment_health"
        android:icon="@drawable/ic_notifications_black_24dp"
        android:title="@string/title_health" />
</menu>

修改后保留原Java代码即可，NavigationUI会自动完成匹配导航。

方案2：手动建立ID映射（保留现有ID） #

如果不想修改ID，可通过设置点击监听器手动处理跳转，同时移除原NavigationUI.setupWithNavController调用：

// 替换原NavigationUI.setupWithNavController(binding.navView, navController); 代码
binding.navView.setOnNavigationItemSelectedListener(item -> {
    NavController navController = Navigation.findNavController(this, R.id.nav_host_fragment_activity_main);
    int destinationId;
    switch (item.getItemId()) {
        case R.id.menu_home:
            destinationId = R.id.fragment_home;
            break;
        case R.id.menu_dashboard:
            destinationId = R.id.fragment_dashboard;
            break;
        case R.id.menu_health:
            destinationId = R.id.fragment_health;
            break;
        default:
            return false;
    }
    // 避免重复跳转同一页面
    if (navController.getCurrentDestination() != null && navController.getCurrentDestination().getId() != destinationId) {
        navController.navigate(destinationId);
    }
    return true;
});

注意事项 #

• AppBarConfiguration中传入的是菜单项ID，无需修改，它用于配置ActionBar的返回行为，与页面跳转逻辑无关。
• 若使用方案2，建议添加重复跳转判断，避免多次点击同一菜单项时重复入栈。

内容的提问来源于stack exchange，提问作者c-an