使用Jetpack Navigation全局导航时触发IllegalArgumentException问题求助

异常原因 #

你遇到的IllegalArgumentException核心原因是：全局Actionaction_global_3定义在被include的子导航图（second.xml）中，而当前导航目的地AFragment属于主导航图（first.xml）。Jetpack Navigation的规则是：子导航图内定义的全局Action默认仅对该子图内部的目的地可见，主导航图的目的地无法直接访问子图中的全局Action，因此触发"找不到action"的异常。

解决方案 #

方案1：将全局Action移至主导航图 #

修改主导航图first.xml，把action_global_3从子导航图移到主导航图的根<navigation>标签下：

<?xml version="1.0" encoding="utf-8"?>
<navigation xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    xmlns:tools="http://schemas.android.com/tools"
    android:id="@id/first"
    app:startDestination="@id/AFragment">

    <fragment
        android:id="@+id/AFragment"
        android:name="com.myexample.AFragment">
    </fragment>

    <include app:graph="@navigation/second" />

    <!-- 将全局Action移至主导航图根节点 -->
    <action
        android:id="@+id/action_global_3"
        app:destination="@id/BFragment" />
</navigation>

同时删除second.xml中对应的action_global_3节点，此时主导航图的AFragment即可正常识别该全局Action。

方案2：直接通过目的地ID导航 #

如果不想调整导航图结构，可绕过全局Action，直接使用目标Fragment的ID完成全局跳转，修改AFragment中的调用代码：

NavHostFragment.findNavController(this).navigate(R.id.BFragment)

这种方式无需依赖预定义的全局Action，直接指定目标目的地ID即可实现跨导航图的跳转。

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