XCode构建React Native iOS项目失败问题求助

问题概述 #

React Native 0.74.3 项目集成 @react-native-firebase/app（v20.3.0）和 messaging 时，执行 pod install 遇到 Swift pod 静态库集成错误；添加 use_modular_headers! 后 pod 安装成功，但 Xcode 编译时提示找不到 FirebaseCoreInternal.modulemap。

解决方案 #

方案1：仅给冲突依赖启用模块化头文件 #

全局启用 use_modular_headers! 易引发其他库兼容性问题，改为针对特定依赖单独配置：

1. 移除 Podfile 中的全局 use_modular_headers!
2. 在 target 'MyRNApp' 代码块内添加：

pod 'GoogleUtilities', :modular_headers => true
pod 'FirebaseCoreInternal', :modular_headers => true

3. 执行清理与重装命令：

cd ios && pod deintegrate && rm Podfile.lock && pod install

方案2：降级 Firebase 适配 React Native 版本 #

@react-native-firebase v20.x 与 React Native 0.74.x 可能存在兼容性问题，尝试降级到稳定兼容版本：

1. 修改 package.json 中的 Firebase 依赖：

"@react-native-firebase/app": "^19.2.2",
"@react-native-firebase/messaging": "^19.2.2"

2. 更新依赖并重装 pods：

npm install
cd ios && pod deintegrate && rm Podfile.lock && pod install

方案3：彻底清理构建缓存 #

缓存残留可能导致模块映射文件丢失，执行以下步骤：

1. 关闭 Xcode
2. 删除项目 DerivedData：

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

3. 清理 iOS 目录下的 pod 缓存：

cd ios && pod clean && rm -rf Pods && rm Podfile.lock
pod install

4. 重新打开 Xcode，按 Cmd+Shift+K 清理构建文件夹，再重新编译项目

方案4：切换为动态框架链接 #

改用动态框架模式避免静态库的模块化头文件冲突：

1. 修改 Podfile 中的框架配置部分：

linkage = ENV['USE_FRAMEWORKS'] || 'dynamic'
if linkage != nil
  Pod::UI.puts "Configuring Pod with #{linkage}ally linked Frameworks".green
  use_frameworks! :linkage => linkage.to_sym
end

2. 重装 pods：

cd ios && pod deintegrate && rm Podfile.lock && pod install

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