添加@react-native-firebase/storage后React Native iOS项目构建失败

问题背景 #

在React Native项目中集成多个Firebase服务时，iOS构建触发上述错误，移除@react-native-firebase/storage模块后项目可正常运行。

环境配置 #

package.json依赖 #

"@react-native-firebase/app": "^16.4.3",
"@react-native-firebase/auth": "^16.4.3",
"@react-native-firebase/crashlytics": "^16.4.3",
"@react-native-firebase/database": "^16.4.3",
"@react-native-firebase/dynamic-links": "^16.4.3",
"@react-native-firebase/firestore": "^16.4.3",
"@react-native-firebase/messaging": "^16.4.3",
"@react-native-firebase/storage": "^16.4.3",

Podfile关键片段 #

platform :ios, '12.1'

pod 'Firebase', :modular_headers => true
pod 'FirebaseCoreInternal', :modular_headers => true
pod 'GoogleUtilities', :modular_headers => true
pod 'FirebaseAppCheckInterop', :modular_headers => true
pod 'FirebaseAuthInterop', :modular_headers => true
pod 'FirebaseCore', :modular_headers => true
pod 'FirebaseCoreExtension', :modular_headers => true
pod 'GTMSessionFetcher', :modular_headers => true

修复步骤 #

1. 补全FirebaseStorage的模块化头配置 #

在Podfile的全局pod声明区域添加以下行，确保FirebaseStorage启用模块化头：

pod 'FirebaseStorage', :modular_headers => true

2. 彻底清理并重装依赖 #

执行以下命令清理缓存并重新安装所有依赖：

# 清理Node.js依赖
rm -rf node_modules package-lock.json yarn.lock
npm install

# 清理iOS Pods并重新安装
cd ios
rm -rf Pods Podfile.lock
pod deintegrate
pod install --repo-update
cd ..

3. 验证Xcode头文件路径配置 #

打开Xcode项目，选中MyApp目标，进入Build Settings：

• 搜索Header Search Paths
• 确认包含$(inherited)和${PODS_ROOT}/FirebaseStorage/Headers（通常Pods会自动配置，若缺失手动添加）

4. 检查版本一致性 #

确保所有@react-native-firebase包版本统一（当前配置已满足），同时Podfile.lock中FirebaseStorage的版本与其他Firebase组件版本匹配，避免版本冲突。

5. 备选方案：使用静态框架（若上述步骤无效） #

如果仍报错，可尝试在Podfile中启用静态框架（注意需注释Flipper相关配置，因为Flipper不兼容静态框架）：

# 注释Flipper配置
# use_flipper!({ 'Flipper' => '0.95.0', 'Flipper-Folly' => '2.6.7', 'Flipper-DoubleConversion' => '3.1.7' })

# 添加静态框架设置
use_frameworks! :linkage => :static

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