React Navigation深度链接无法跳转目标页面问题求助

初始配置的核心错误 #

初始linking配置完全没有对齐实际导航树层级：

• 应用最外层根Stack导航仅注册了Main路由，Main挂载的组件才是包含Discover、Theater的二级Stack，Theater挂载的组件才是BottomTab导航下的Watch路由。
• 初始配置直接将Discover、Theater放在配置根节点的screens下，和实际导航结构完全不匹配，React Navigation解析URL生成的导航状态找不到对应根路由，直接抛出路由不匹配警告，自然不会触发跳转。

补全Main层级后仍不跳转的原因 #

补全Main层级后跳转失败是三个问题叠加导致：

• 嵌套导航未配置各层级初始路由：React Navigation解析嵌套路由时，要求每个导航层级明确指定initialRouteName，否则无法自动构建完整的父级导航栈，只会监听到链接事件，不会执行实际跳转动作。
• 路径参数配置与实际接收URL不匹配：更新配置时删除了watch/:name?的可选参数标记，改为watch/:name后要求路径必须携带name参数才能匹配；同时从事件日志看，触发test://watch/test时应用实际接收到的URL丢失了/test路径段，变为test://watch，进一步导致匹配失败。
• Bugsnag导航容器兼容问题：使用的Bugsnag createNavigationContainer 包装器低版本对React Navigation 6的linking动作透传存在已知bug，会拦截深度链接触发的导航操作，表现为能监听到深链事件但页面不跳转。

修复步骤 #

1. 修正linking配置，为每个嵌套导航层级添加initialRouteName，恢复路径参数的可选标记，增加路径日志确认实际接收的URL：

const config = {
  screens: {
    Main: {
      initialRouteName: 'Discover',
      screens: {
        Discover: 'discover',
        Theater: {
          initialRouteName: 'Watch',
          screens: {
            Watch: 'watch/:name?',
          },
        },
      },
    },
  },
}

export const linking: LinkingOptions<any> = {
  prefixes: ['test://'],
  config,
  getPathFromURL: (url) => {
    console.log('received deep link full url:', url)
    return url.replace(/^test:\/\//, '')
  }
}

2. 移除TheaterStackScreen中手动注入initialParams的逻辑，深度链接解析出的路径参数会由React Navigation自动注入到对应路由的route.params中，手动绑定初始参数反而会覆盖透传的参数值：

const Tab = createBottomTabNavigator()
export function TheaterStackScreen() {
  return (
    <Tab.Navigator screenOptions={{headerShown: false}}>
      <Tab.Screen name="Watch" component={WatchScreen} />
    </Tab.Navigator>
  )
}

3. 检查Android端Manifest配置：找到注册了深链scheme的Activity，确认intent-filter的data标签配置了通配pathPattern，避免系统截断路径：

<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="test" android:host="*" android:pathPattern=".*" />
</intent-filter>

4. 升级Bugsnag React Navigation插件到最新版本，或临时替换为原生NavigationContainer测试跳转，排除插件拦截问题。

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