使用Navigation组件点击ActionBar图标无法跳转至目标Fragment如何解决

核心失效原因 #

• 带android:actionLayout的自定义布局菜单项，默认不会触发onOptionsItemSelected回调。这类菜单项的触摸事件会被布局内的View直接消费，完全不走菜单的选中事件分发流程，你在onOptionsItemSelected里写的判断逻辑根本没有被执行的机会。
• 缺少菜单加载逻辑：没有重写onCreateOptionsMenu方法inflate对应的menu资源，购物车图标根本不会渲染到ActionBar上。
• 导航逻辑缺少防重复判断：直接调用navController.navigate(R.id.cartFragment)时没有配置栈行为，在已处于购物车页面时重复点击会重复创建Fragment实例、出现栈错乱问题。

分步修复操作 #

1. 加载菜单并修复自定义布局的点击事件 #

在MainActivity中重写onCreateOptionsMenu方法，加载菜单资源的同时，直接给自定义布局View绑定点击跳转逻辑，绕开自定义布局事件不触发菜单回调的限制：

@Override
public boolean onCreateOptionsMenu(Menu menu) {
    // 把action_menu.xml加载到ActionBar
    getMenuInflater().inflate(R.menu.action_menu, menu);
    // 拿到购物车菜单项的自定义布局（也就是你的notification_badge布局）
    MenuItem cartItem = menu.findItem(R.id.cart_notif);
    View cartActionView = MenuItemCompat.getActionView(cartItem);
    // 直接给这个布局绑定点击监听，处理跳转
    cartActionView.setOnClickListener(v -> {
        NavController navController = Navigation.findNavController(MainActivity.this, R.id.fragment);
        // 导航配置：目标已在栈顶时不重复创建实例
        NavOptions navOptions = new NavOptions.Builder()
                .setLaunchSingleTop(true)
                .build();
        navController.navigate(R.id.cartFragment, null, navOptions);
    });
    return true;
}

如果你不需要这个带角标的自定义布局，直接删掉menu item里的android:actionLayout属性，普通图标菜单项就可以正常触发onOptionsItemSelected回调，你原来写在回调里的跳转逻辑就能生效。

2. 绑定NavController与ActionBar的联动 #

不要手动重复写导航判断逻辑，用Navigation组件自带的绑定方法统一处理ActionBar的返回、菜单联动逻辑：

@Override
protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_main);
    // 初始化NavController
    NavController navController = Navigation.findNavController(this, R.id.fragment);
    // 把NavController和ActionBar做绑定，自动适配返回箭头、页面标题的更新
    NavigationUI.setupActionBarWithNavController(this, navController);
}

@Override
public boolean onSupportNavigateUp() {
    NavController navController = Navigation.findNavController(this, R.id.fragment);
    // 用统一的导航逻辑处理返回
    return NavigationUI.navigateUp(navController, null);
}

3. 优化导航跳转的栈行为 #

建议在nav_host.xml的根节点下添加全局跳转动作，替代直接跳目标ID的写法，避免页面栈错乱：

<!-- 写在navigation根标签下，和其他fragment同级，不要嵌在某个fragment内部 -->
<action
    android:id="@+id/action_global_to_cart"
    app:destination="@id/cartFragment"
    app:launchSingleTop="true"
    app:popUpTo="@id/start_destination"
    app:popUpToInclusive="false"/>

点击购物车图标时，直接调用这个全局动作ID跳转，不管当前在哪个页面，都可以正确回到购物车页面，不会出现重复入栈、栈层级混乱的问题。

内容的提问来源于stack exchange，提问作者Digvijay Singh Thakur