安装react-native-touch-id后iOS出现AppRegistry调用错误求助

核心原因排查 #

该报错大概率是react-native-touch-id与当前React Native版本不兼容，或是原生模块链接/构建缓存冲突导致桥接初始化失败。注意：react-native-touch-id已停止维护，官方推荐使用更活跃的替代库。

针对性解决步骤 #

1. 版本兼容性校验 #

• 查看package.json中react-native版本，对比react-native-touch-id的官方版本要求（旧版本touch-id仅支持RN 0.59及以下，RN 0.60+需适配新架构的分支版本，但该库已无更新）。
• 直接替换为维护活跃的生物识别库（推荐方案）：
  • 卸载旧库：npm uninstall react-native-touch-id
  • 安装替代库：npm install react-native-biometrics
  • 重新执行iOS依赖安装：cd ios && pod install --repo-update

2. iOS端构建缓存与链接修复 #

• 彻底清理iOS依赖缓存：
  1. 删除ios/Pods文件夹、ios/Podfile.lock文件
  2. 打开Xcode，删除Derived Data（路径：Xcode > Preferences > Locations > Derived Data，点击路径打开后删除对应项目文件夹）
  3. 执行cd ios && pod install --repo-update
• 手动检查原生模块链接：
  1. 打开Xcode项目，查看Libraries目录下是否存在RNTouchID.xcodeproj
  2. 进入Build Phases > Link Binary With Libraries，确认libRNTouchID.a已添加（RN 0.60+自动链接失效时需手动添加）

3. JS端缓存与初始化顺序校验 #

• 重置Metro缓存：npx react-native start --reset-cache
• 检查生物识别API调用时机：确保在App完全初始化后调用（如在App.js的useEffect中添加延迟，或在主页面渲染完成后触发），避免在AppRegistry注册完成前调用原生模块。

4. 桥接初始化检查 #

• 打开ios/[项目名]/AppDelegate.m，确认RCTBridge初始化代码未被修改，AppRegistry.runApplication调用位于正确位置：

  RCTBridge *bridge = [[RCTBridge alloc] initWithDelegate:self launchOptions:launchOptions];
  RCTRootView *rootView = [[RCTRootView alloc] initWithBridge:bridge
                                                   moduleName:@"YourAppName"
                                            initialProperties:nil];
  

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