React Native构建iOS应用报错RNFirebase核心模块原生未找到求助

解决方案 #

核心问题是你项目中Firebase依赖版本冲突，且iOS原生配置缺失，按以下步骤修复即可：

1. 修复依赖冲突 #

你同时安装了旧版react-native-firebase v5和新版@react-native-firebase官方全家桶，两个版本完全不兼容，安卓能正常运行是因为jetify处理了旧包的安卓端兼容性，iOS端没有对应处理所以报错。请先确定你要使用的Firebase版本，删除另一个版本的依赖：

• 若使用新版@react-native-firebase，卸载旧版包：

  npm uninstall react-native-firebase
  # 用yarn的话执行 yarn remove react-native-firebase
  

• 若坚持使用旧版react-native-firebase v5，卸载所有新版相关依赖：

  npm uninstall @react-native-firebase/app @react-native-firebase/messaging
  # 用yarn的话执行 yarn remove @react-native-firebase/app @react-native-firebase/messaging
  

2. 修正iOS Podfile配置 #

• 如果选择使用旧版react-native-firebase v5，需要手动在Podfile的target块内添加对应依赖，修改后Podfile的target部分如下：

  target 'leaders' do
      use_unimodules!
      config=use_native_modules!
      use_react_native!(:path=>config["reactNativePath"])
      # 手动添加RNFirebase及你用到的Firebase服务pod
      pod 'RNFirebase', :path => '../node_modules/react-native-firebase/ios'
      pod 'Firebase/Core'
      pod 'Firebase/Firestore'
      pod 'Firebase/Messaging'
  end
  

• 如果选择使用新版@react-native-firebase，无需手动修改Podfile，RN的autolinking机制会自动处理依赖。

3. 全量清理缓存并重新构建 #

# 1. 清理js依赖缓存
rm -rf node_modules package-lock.json yarn.lock
# 2. 重新安装js依赖
npm install # 用yarn的话执行yarn install
# 3. 清理iOS原生构建缓存
cd ios && rm -rf Pods Podfile.lock build ~/Library/Developer/Xcode/DerivedData/*
# 4. 重新安装pod依赖
pod install --repo-update
# 5. 回到项目根目录，启动Metro并清理缓存
cd .. && npx react-native start --reset-cache
# 6. 新开终端窗口，运行iOS项目
npx react-native run-ios

你遇到的"main" has not been registered报错是因为Firebase模块加载失败，导致入口处的AppRegistry.registerComponent没有被执行，Firebase相关问题修复后这个报错会自动消失。
如果你需要在Expo Go中运行项目，不能使用需要原生配置的react-native-firebase系列包，需要换成Expo官方封装的firebase模块。

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