React Native iOS集成Firebase Storage报错：找不到指定头文件

问题背景 #

在React Native iOS项目中集成@react-native-firebase/storage@16.7.0时，编译报错：'FirebaseStorage/FirebaseStorage-Swift.h' 文件未找到，项目已配置其他Firebase模块（app、auth、messaging）且版本统一为16.7.0。

解决方案 #

1. 补充Podfile中FirebaseStorage的模块化头配置 #

当前Podfile已为多个Firebase核心组件设置:modular_headers => true，但缺少FirebaseStorage的对应配置。在全局pod配置区域新增一行：

pod 'FirebaseStorage', :modular_headers => true

修改后的全局pod配置片段如下：

pod 'Firebase', :modular_headers => true
pod 'FirebaseCoreInternal', :modular_headers => true
pod 'GoogleUtilities', :modular_headers => true
pod 'FirebaseCore', :modular_headers => true
pod 'FirebaseAppCheckInterop', :modular_headers => true
pod 'FirebaseAuthInterop', :modular_headers => true
pod 'FirebaseCoreExtension', :modular_headers => true
pod 'GTMSessionFetcher', :modular_headers => true
pod 'FirebaseStorage', :modular_headers => true # 新增该行
$RNFirebaseAsStaticFramework = true

2. 清理并重新安装依赖 #

执行以下命令彻底清理旧缓存并重新安装：

cd ios
pod deintegrate
rm -rf Podfile.lock
rm -rf ../node_modules
npm install # 或使用 yarn install
pod install

3. 验证Xcode项目配置 #

• 打开Xcode，进入项目Build Settings，确保Always Search User Paths设置为YES
• 检查Header Search Paths是否包含$(inherited)，该配置会自动引入Pods的头文件路径

4. 确保项目支持Swift编译 #

Firebase Storage的Swift头文件依赖项目的Swift支持：

• 在Xcode中新增一个空Swift文件（如Dummy.swift），系统会提示创建桥接文件，确认创建即可
• 若已有桥接文件，确保未屏蔽Firebase相关的导入逻辑

额外提示 #

由于你设置了$RNFirebaseAsStaticFramework = true，需保证所有Firebase相关Pods均以静态框架方式编译，避免动态/静态框架冲突导致的编译问题。

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