iOS端React Navigation深层链接重复配置报错排查求助

报错信息 #

Looks like you have configured linking in multiple places. This is likely an error since deep links should only be handled in one place to avoid conflicts. Make sure that:

• You don't have multiple NavigationContainers in the app each with 'linking' enabled
• Only a single instance of the root component is rendered

排查思路与解决方案 #

1. 版本兼容性排查 #

确认React Navigation及相关依赖（如@react-navigation/native、react-native-screens等）的版本是否存在iOS端误报bug。尝试升级到最新稳定版，或回退至之前验证过的稳定版本测试。

2. 彻底清理iOS构建缓存 #

执行以下步骤清除所有可能的缓存：

• 关闭Xcode、Metro服务及模拟器
• 删除项目根目录的node_modules，重新执行npm install/yarn install
• 进入iOS目录，删除Pods文件夹和Podfile.lock，执行pod install
• 在Xcode中选择Product -> Clean Build Folder
• 模拟器测试的话，执行Hardware -> Erase All Content and Settings清空模拟器
• 重启Metro并重新构建项目

3. 检查AppDelegate.mm的链接处理代码 #

确认AppDelegate中是否存在重复的深层链接逻辑：

• 确保仅保留React Navigation官方推荐的链接处理代码，避免手动添加的openURL或第三方库的链接逻辑冲突
• 正确的代码示例：

  #import <React/RCTLinkingManager.h>
  
  - (BOOL)application:(UIApplication *)application openURL:(NSURL *)url
    options:(NSDictionary<UIApplicationOpenURLOptionsKey,id> *)options
  {
    return [RCTLinkingManager application:application openURL:url options:options];
  }
  
  - (BOOL)application:(UIApplication *)application continueUserActivity:(nonnull NSUserActivity *)userActivity
    restorationHandler:(nonnull void (^)(NSArray<id<UIUserActivityRestoring>> * _Nullable))restorationHandler
  {
    return [RCTLinkingManager application:application continueUserActivity:userActivity restorationHandler:restorationHandler];
  }
  

4. 排查第三方库干扰 #

检查项目中是否存在其他处理深层链接的第三方SDK（如推送、统计类库），这些库可能与React Navigation的链接逻辑冲突。暂时移除这类库，测试错误是否消失。

5. 验证NavigationContainer的ref配置 #

检查navigationRef的定义是否正确，是否在其他地方被重复引用导致组件异常渲染。尝试移除ref属性，测试报错是否消失。

6. 检查Info.plist的scheme配置 #

打开Info.plist，查看CFBundleURLTypes数组，确保apptest:// scheme仅被声明一次，不存在重复配置条目。

内容的提问来源于stack exchange，提问作者Péter Csutorás