Navigation Components生成DeepLinks遇循环引用及Intent解析失败问题排查

你遇到的两个错误其实是关联的：

1. 导航图循环引用：你在MainActivity的Manifest里同时引用了main_graph和second_graph，而这两个导航图之间大概率存在互相<include>的情况（比如main_graph引入了second_graph，second_graph又反过来引入main_graph），导致系统遍历导航引用时检测到非法循环，直接触发Manifest合并失败。
2. DeepLink无法解析：由于Manifest合并失败，导航组件无法为你的DeepLink生成对应的Intent过滤器，系统自然找不到能处理myapp://test这个DeepLink的MainActivity，所以出现Activity未启动的错误。

1. 修复导航图的循环引用问题 #

先打开main_graph.xml和second_graph.xml检查：

• 如果你在main_graph里写了<include app:graph="@navigation/second_graph"/>，同时second_graph里又有<include app:graph="@navigation/main_graph"/>，必须删除其中一个引用——导航组件不允许导航图之间形成循环依赖。
• 如果两个导航图需要互相跳转目标页面，不要用<include>引入整个导航图，而是通过<action>标签配置跳转路径，或者直接在目标页面的DeepLink里指定跳转逻辑。

2. 修正Manifest中的导航图引用 #

同一个Activity不能同时绑定多个独立的导航图，正确的做法是：

• 只保留一个<nav-graph>标签指向主导航图（比如main_graph）：

<activity android:name=".framework.activities.MainActivity" 
    android:configChanges="orientation|keyboardHidden" 
    android:launchMode="singleTop" 
    android:windowSoftInputMode="adjustResize" 
    android:screenOrientation="portrait" >
    <nav-graph android:value="@navigation/main_graph" />
</activity>

• 如果需要引入second_graph，在main_graph.xml里通过<include>标签嵌套（确保没有循环）：

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

    <!-- 其他目的地 -->
    <include app:graph="@navigation/second_graph" />

</navigation>

3. 确保DeepLink配置正确 #

检查你要跳转的目标页面（比如second_graph里的某个Fragment）是否正确配置了DeepLink：

<fragment
    android:id="@+id/test_target_fragment"
    android:name="com.yourpackage.TestTargetFragment">
    <!-- 配置DeepLink -->
    <deepLink
        android:id="@+id/deep_link_test"
        app:uri="myapp://test" />
</fragment>

4. 验证导航宿主配置 #

确认MainActivity的布局里正确设置了NavHostFragment作为导航宿主：

<androidx.fragment.app.FragmentContainerView
    android:id="@+id/nav_host_fragment"
    android:name="androidx.navigation.fragment.NavHostFragment"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    app:defaultNavHost="true"
    app:navGraph="@navigation/main_graph" />

5. 测试DeepLink #

用adb命令测试DeepLink是否能正常触发：

adb shell am start -W -a android.intent.action.VIEW -c android.intent.category.BROWSABLE -d myapp://test

如果配置正确，MainActivity应该会启动并跳转到对应的目标页面。

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