Android动态特性模块下底部导航子导航图导航失效问题求助

这是使用Navigation组件+动态特性模块时很容易踩的一个坑，核心原因是你用错了NavController实例——主导航图的NavController没有子导航图里动作的上下文，所以才会抛出navigation destination ... is unknown to this NavController的错误。

下面是具体的修复步骤和原理：

1. 换用正确的NavController实例 #

在你的Tab01Fragment中，不要使用从HomeFragment传递过来的innerNavController（那是主导航图的实例），直接调用Fragment自带的findNavController()方法。这个方法会自动获取当前Fragment所在的子导航图对应的NavController，它能识别子导航图里定义的所有动作和目标页面。

修改点击事件的代码：

// 原错误代码（使用了主导航图的NavController）
// innerNavController.navigate(R.id.action_news_list_to_detail)

// 正确代码：获取当前Fragment所属的子导航图NavController
findNavController().navigate(R.id.action_news_list_to_detail)

2. 校验动态模块导航图的配置 #

先确认动态模块的nav_tab_01.xml里，导航动作和目标页面的ID没有拼写错误：

<navigation xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    android:id="@+id/nav_tab_01"
    app:startDestination="@id/tab01Fragment">

    <fragment
        android:id="@+id/tab01Fragment"
        android:name="org.example.dfm01.Tab01Fragment">
        <!-- 确认动作ID和目标ID完全匹配 -->
        <action
            android:id="@+id/action_news_list_to_detail"
            app:destination="@id/newsDetailFragment" />
    </fragment>

    <fragment
        android:id="@+id/newsDetailFragment"
        android:name="org.example.dfm01.NewsDetailFragment" />
</navigation>

3. 确认主导航图的配置准确 #

检查nav_graph_home.xml中的<include-dynamic>参数是否和动态模块的实际信息完全一致：

• moduleName：必须和动态模块build.gradle里的模块名称一致（比如你的example_dfm_01）
• graphPackage：动态模块的包名（比如org.example.dfm01）
• graphResName：动态模块导航图的文件名（不含.xml，比如nav_tab_01）

举个动态模块example_dfm_01的build.gradle参考配置：

plugins {
    id 'com.android.dynamic-feature'
    id 'kotlin-android'
}

android {
    namespace "org.example.dfm01"
    // 其他配置...
}

dependencies {
    implementation project(':app')
    // 其他依赖...
}

4. 按需加载场景的额外处理（如果适用） #

如果你的动态模块是按需下载的，在导航前需要确保模块已经安装完成。可以用DynamicNavController的重载方法自动处理安装流程：

val navController = findNavController()
val installExtras = DynamicExtras(
    installModuleTask = navController.installModule(R.id.newsDetailFragment)
)
navController.navigate(
    R.id.action_news_list_to_detail,
    null,
    null,
    installExtras
)

为什么之前的代码会报错？ #

你在HomeFragment中获取的innerNavController是绑定到主导航图nav_graph_home.xml的实例，主导航图只包含了<include-dynamic>标签，并没有直接包含子导航图里的action_news_list_to_detail动作——这个动作属于动态模块的子导航图，只有子导航图的NavController才能识别它。

而findNavController()会基于当前Fragment的上下文，找到对应的子导航图NavController，自然就能识别到定义在子导航图里的所有导航动作了。

内容的提问来源于stack exchange，提问作者Marlon López