React Native iOS构建报错：'FirebaseAuth/FirebaseAuth-Swift.h'文件未找到

报错信息 #

/Users/shashiagarwal/temp-data/astroduniaios/ios/Pods/Headers/Private/Firebase/Firebase.h:40:15 
'FirebaseAuth/FirebaseAuth-Swift.h' file not found

当前配置 #

Podfile:

platform :ios, '12.0'
use_frameworks! :linkage => :static

target 'astroduniaios' do
use_react_native!(:path => config[:reactNativePath])

pod 'Firebase', :modular_headers => true
pod 'FirebaseAuth', :modular_headers => true

 post_install do |installer|
   react_native_post_install(installer, config[:reactNativePath])
 end
end

package.json依赖:

{
  "dependencies": {
    "@react-native-firebase/app": "^21.10.1",
    "@react-native-firebase/auth": "^21.10.1"
  }
}

可行解决方案 #

方案1：移除手动添加的Firebase Pod声明（推荐）

@react-native-firebase库会自动处理Firebase原生依赖的引入，手动添加pod 'Firebase'和pod 'FirebaseAuth'容易导致版本冲突或头文件配置异常。修改Podfile如下：

platform :ios, '12.0'
use_frameworks! :linkage => :static

target 'astroduniaios' do
use_react_native!(:path => config[:reactNativePath])

# 移除手动添加的Firebase相关pod声明

 post_install do |installer|
   react_native_post_install(installer, config[:reactNativePath])
 end
end

执行清理和重装操作：

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

方案2：调整模块化头配置，覆盖所有Firebase子Pod

如果需要保留手动Pod声明，确保所有Firebase相关组件都启用模块化头文件，在Podfile中添加全局配置：

platform :ios, '12.0'
use_frameworks! :linkage => :static

# 全局启用Firebase所有子Pod的模块化头
pre_install do |installer|
  installer.pod_targets.each do |pod|
    if pod.name.start_with?('Firebase')
      pod.build_configurations.each do |config|
        config.build_settings['CLANG_MODULES_AUTOLINK'] = 'YES'
        config.build_settings['DEFINES_MODULE'] = 'YES'
      end
    end
  end
end

target 'astroduniaios' do
use_react_native!(:path => config[:reactNativePath])

pod 'Firebase', :modular_headers => true
pod 'FirebaseAuth', :modular_headers => true

 post_install do |installer|
   react_native_post_install(installer, config[:reactNativePath])
 end
end

执行重装命令：

cd ios
pod install --repo-update

方案3：切换框架链接方式为动态

尝试将静态链接改为动态链接，部分场景下可解决Swift头文件找不到的问题：

platform :ios, '12.0'
use_frameworks! :linkage => :dynamic

target 'astroduniaios' do
use_react_native!(:path => config[:reactNativePath])

# 推荐移除手动Firebase pod声明
 post_install do |installer|
   react_native_post_install(installer, config[:reactNativePath])
 end
end

执行清理重装：

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

方案4：清理Xcode缓存并重新构建

1. 完全关闭Xcode
2. 清理Xcode派生数据缓存：

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

3. 回到项目目录重新安装Pods：

cd ios
pod install

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

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