RN 0.70.2升级至0.72.0后Xcode构建报错：找不到FirebaseCoreInternal.modulemap

架构老林

2026-7-17

解决React Native升级后iOS构建找不到FirebaseCoreInternal.modulemap的问题

核心排查与解决步骤

问题源于RN版本升级后Firebase相关Pod依赖的版本不兼容或配置缺失，以下是针对性修复方案：

1. 统一@react-native-firebase包版本

确保package.json中所有@react-native-firebase/*类包（如app、auth、storage等）使用完全一致的版本，且版本需适配React Native 0.72.0（推荐18.x及以上版本）。修改后执行：

rm -rf node_modules package-lock.json yarn.lock
npm install # 或 yarn install

2. 手动指定FirebaseCoreInternal版本

在iOS目录的Podfile中添加对应版本的依赖，确保与Firebase主版本匹配，示例：

pod 'FirebaseCoreInternal', '10.12.0'

随后执行：

cd ios
rm -rf Pods Podfile.lock
pod install --repo-update

3. 修复Xcode头文件搜索路径

打开Xcode项目，进入目标Target的Build Settings，找到Header Search Paths，添加以下路径并设置为Recursive：

$(SRCROOT)/Pods/FirebaseCoreInternal

4. 彻底清理构建缓存

删除Xcode DerivedData：前往~/Library/Developer/Xcode/DerivedData，删除当前项目对应的文件夹
在Xcode中执行Product > Clean Build Folder（快捷键Cmd+Shift+K）

5. 调整Pod架构配置

在Podfile的post_install钩子中添加架构限制，确保仅针对arm64构建：

post_install do |installer|
  installer.pods_project.targets.each do |target|
    target.build_configurations.each do |config|
      config.build_settings['ARCHS[sdk=iphoneos*]'] = 'arm64'
      config.build_settings['EXCLUDED_ARCHS[sdk=iphonesimulator*]'] = 'i386 x86_64'
    end
  end
end

修改后重新执行pod install。