使用Android Navigation Component配置Deep Link打开错误页面求助

看起来你已经走对了大部分流程，但几个小细节可能导致Deep Link没生效，我来帮你排查：

1. URI匹配不精确 #

你导航图里的Deep Link URI是example://gizmos，但测试命令里用的是example://gizmos/（多了末尾的斜杠）。Navigation Component对URI的匹配是精确匹配，这俩会被视为不同的地址，所以系统找不到对应的Deep Link目标，就跳转到了默认的firstFragment。

修复方法：

• 要么把测试命令改成不带斜杠的版本：

  adb shell am start -W -a android.intent.action.VIEW -d "example://gizmos"
  

• 要么修改导航图里的deepLink标签，把URI改成带斜杠的：

  <deepLink android:id="@+id/deepLink" app:uri="example://gizmos/" />
  

2. 检查NavHostFragment是否正确配置 #

这是最容易被忽略的点：你的MainActivity必须包含NavHostFragment，并且关联到你的导航图，否则Navigation Component根本不知道该把Deep Link的Intent交给谁处理。

打开MainActivity的布局文件（比如activity_main.xml），确保有以下配置：

<!-- 推荐用FragmentContainerView，兼容更优 -->
<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/navigation_graph" /> <!-- 关联你的导航图 -->

如果用的是旧版的<fragment>标签，也可以，但FragmentContainerView是官方推荐的方式。

3. 验证自动生成的Intent Filter是否存在 #

当你在Manifest里添加<nav-graph>标签后，Android Gradle插件会自动为你的MainActivity生成对应的Intent Filter。你可以通过以下方式验证：

1. Build你的应用 -> 生成APK
2. 用Android Studio的Build > Analyze APK打开生成的APK
3. 查看AndroidManifest.xml，检查MainActivity下是否有类似这样的Intent Filter：

<intent-filter>
    <action android:name="android.intent.action.VIEW" />
    <category android:name="android.intent.category.DEFAULT" />
    <category android:name="android.intent.category.BROWSABLE" />
    <data android:scheme="example" android:host="gizmos" />
</intent-filter>

如果没有这个Intent Filter，说明：

• 你的Navigation Component依赖版本太低（需要至少2.3.0以上）
• 导航图的路径引用错误（比如@navigation/navigation_graph写错了）

4. 清理应用缓存/重装应用测试 #

有时候系统会缓存旧的Intent Filter配置，导致新的Deep Link不生效。可以先卸载应用，再重新安装，或者在设置里清理应用缓存，然后再用adb命令测试。

额外测试技巧 #

如果还是有问题，可以尝试从浏览器里打开这个Deep Link（比如在Chrome里输入example://gizmos），看是否能正确跳转。如果浏览器提示无法打开，说明Intent Filter根本没生效；如果能打开但还是跳默认页面，再回到导航图和NavHost的配置检查。

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