Navigation组件隐式深链接跳转后回退栈为空 无法返回主图起始页

Navigation组件处理隐式深链接时，若深链接直接指向嵌套图内部的目的地，默认回退栈构造逻辑不会自动向上回溯所有层级的父导航图入口目的地，仅会将深链接目标本身（或其所属嵌套图的直接起点）入栈，因此回退栈中不会包含主图的起始目的地A。这种场景在非单Activity架构下会进一步放大问题：当深链接独立启动承载导航图的MyActivity时，系统会创建独立任务栈，若未配置栈关联，回退栈会完全缺失上层导航节点。

1. 给深链接补充回退栈关联属性 #

找到导航图中对应目的地B的<deepLink>标签，补充两个关键属性，强制Navigation构造包含根导航路径的回退栈：

<fragment
    android:id="@+id/destination_b"
    android:name=".DestinationBFragment"
    tools:layout="@layout/fragment_destination_b">

    <!-- 原有深链接配置 -->
    <deepLink
        app:uri="https://www.example.com/path/b"
        app:autoVerify="true"
        <!-- 强制关联全局根导航图，避免仅从嵌套图1构建回退栈 -->
        app:graph="@navigation/my_nav"
        <!-- 指定当前目的地的上一级回退节点为主图起始A -->
        app:parentRoute="@id/destination_a" />
</fragment>

若使用的Navigation版本低于2.4.0，不支持app:parentRoute属性，可直接在目的地B的节点上配置向上导航的pop行为，实现相同的回退效果：

<fragment
    android:id="@+id/destination_b"
    app:popUpTo="@id/my_nav_root"
    app:popUpToInclusive="false">
    <!-- 原有配置 -->
</fragment>

2. 确认嵌套图的全局挂载逻辑 #

检查主导航图中嵌套图1的声明，确保其直接作为主图的子节点挂载，没有独立设置独立的启动逻辑：

<!-- 主导航图 my_nav.xml -->
<navigation
    android:id="@+id/my_nav_root"
    app:startDestination="@id/destination_a">

    <!-- 主图起始目的地A -->
    <fragment
        android:id="@+id/destination_a"
        android:name=".DestinationAFragment"
        tools:layout="@layout/fragment_destination_a" />

    <!-- 嵌套图1 正确挂载方式 -->
    <navigation
        android:id="@+id/nested_graph_1"
        app:startDestination="@id/destination_b">

        <fragment
            android:id="@+id/destination_b"
            android:name=".DestinationBFragment"
            tools:layout="@layout/fragment_destination_b" />

        <fragment
            android:id="@+id/destination_c"
            android:name=".DestinationCFragment"
            tools:layout="@layout/fragment_destination_c" />
    </navigation>

    <!-- 嵌套图2 省略配置 -->
</navigation>

3. 修正Activity的任务栈配置 #

非单Activity架构下，深链接启动MyActivity时容易创建独立隔离的任务栈，需要在Manifest中补充启动模式和任务亲和性配置：

<activity
    android:name=".MyActivity"
    android:screenOrientation="portrait"
    <!-- 新增配置 -->
    android:launchMode="singleTask"
    android:taskAffinity="com.example.myapp.main_task">

    <nav-graph android:value="@navigation/my_nav" />
</activity>

配置说明：

• singleTask启动模式会让深链接启动的MyActivity和应用主入口Activity处于同一任务栈，避免创建完全独立的新栈导致回退栈断裂
• 统一的taskAffinity可以避免不同组件因任务亲和性差异被系统拆分到不同任务栈

4. 清理冗余代码 #

确认完全移除Activity中手动调用navController.handleDeepLink(intent)的逻辑：

• 通过<nav-graph>关联导航图后，Navigation组件会在NavHostFragment初始化时自动解析传入的深链接Intent
• 手动重复调用深链接处理逻辑会打乱默认的回退栈构造顺序

配置完成后，可通过以下方式确认回退栈逻辑正常：

• 给NavController注册OnDestinationChangedListener，在回调中打印navController.currentBackStack内的所有目的地id，确认深链接跳转B后，回退栈顺序为[A, B]
• 全局检查导航图内的目的地id，确保没有重复id导致的节点匹配错误
• 确认没有多个NavHostFragment实例同时绑定同一个NavController

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