React-Native iOS集成Firebase Firestore后构建模块失败求助

问题现象 #

• 执行以下命令成功后应用无法运行：

  npm install @react-native-firebase/firestore 
  cd ios
  pod install
  

• Metro Bundler模拟器运行时，xcodebuild卡在计算目标依赖图阶段；Xcode构建时提示“Could not build module ”
• 已尝试清理Derived Data、Pod缓存，问题未解决

解决方案 #

1. 核对依赖版本兼容性 #

• 确认@react-native-firebase/firestore版本与当前React Native、iOS系统版本匹配（例如React Native 0.70+需对应Firebase SDK 15.x及以上版本）
• 若版本不兼容，卸载当前包并安装适配版本：

  npm uninstall @react-native-firebase/firestore
  npm install @react-native-firebase/firestore@<适配版本号>
  

2. 重新配置Podfile并重装Pods #

• 打开ios/Podfile，确保顶部添加了CocoaPods源：

  source 'https://github.com/CocoaPods/Specs.git'
  

• 确认iOS部署目标符合Firestore要求（最低iOS 11.0）：

  platform :ios, '11.0'
  

• 彻底清理并重装Pods：

  cd ios
  pod deintegrate
  rm Podfile.lock
  pod install --repo-update
  

3. 修复Xcode项目构建配置 #

• 打开Xcode项目，选中目标Target，进入Build Settings：
  • 搜索Framework Search Paths，确保包含$(inherited)和${PODS_ROOT}/FirebaseFirestore
  • 搜索Header Search Paths，添加$(inherited)和${PODS_ROOT}/Headers/Public/FirebaseFirestore
  • 搜索Other Linker Flags，确认包含$(inherited)

4. 彻底清理后重新构建 #

• 清理Xcode Derived Data：

  rm -rf ~/Library/Developer/Xcode/DerivedData
  

• 在Xcode中执行Product -> Clean Build Folder（快捷键Cmd+Shift+K）
• 关闭Metro和Xcode，重新启动Metro并运行项目：

  npx react-native run-ios
  

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