React Native集成Firebase Messaging后iOS编译失败，报“No such module React”等错误

看起来你遇到了React Native集成Firebase时典型的编译配置冲突问题，这类问题大多和Podfile的框架链接设置、模块化头文件配置以及缓存有关。我整理了几个针对性的解决方案，一步步来排查：

1. 修复Podfile的核心配置冲突 #

你的Podfile里同时全局使用了use_modular_headers!和use_frameworks! :linkage => :static，这两个设置的组合容易和React Native的非模块化Pod产生冲突。建议调整为仅针对Firebase系列Pod启用模块化头文件，避免全局配置影响React Native的依赖：

修改后的Podfile示例（关键调整已标注）：

require_relative '../node_modules/react-native/scripts/react_native_pods'
platform :ios, '15.1'
prepare_react_native_project!

# 静态框架链接配置放在最前面，确保所有Pod遵循此规则
use_frameworks! :linkage => :static

target '#######' do
  config = use_native_modules!

  use_react_native!(
    :path => config[:reactNativePath],
    :app_path => "#{Pod::Config.instance.installation_root}/..",
    :hermes_enabled => false,
    :new_arch_enabled => false
  )

  # 仅对Firebase相关Pod启用模块化头文件，兼顾Firebase的要求和React Native的兼容性
  pod 'Firebase', :modular_headers => true
  pod 'FirebaseCore', :modular_headers => true
  pod 'FirebaseMessaging', :modular_headers => true # 你用到的Firebase模块，其他组件如Analytics/Auth同理添加
  # use_native_modules!会自动引入其他React Native第三方Pod，无需手动添加

  post_install do |installer|
    react_native_post_install(
      installer,
      config[:reactNativePath],
      :mac_catalyst_enabled => false
    )

    installer.pods_project.targets.each do |target|
      target.build_configurations.each do |config|
        # 保留模拟器架构排除设置，解决M1/M2芯片模拟器编译问题
        config.build_settings['EXCLUDED_ARCHS[sdk=iphonesimulator*]'] = 'arm64'
        # 允许非模块化头文件引用，解决non-modular-include错误
        config.build_settings['CLANG_ALLOW_NON_MODULAR_INCLUDES_IN_FRAMEWORK_MODULES'] = 'YES'
        # 强制所有Target作为模块化框架编译，避免"No such module"问题
        config.build_settings['DEFINES_MODULE'] = 'YES'
      end
    end
  end
end

调整原因：

• 全局use_modular_headers!会让React Native的所有Pod强制启用模块化，但部分老版本的React Native Pod并不完全支持模块化，这是"No such module React"的核心诱因之一
• 针对Firebase单独启用模块化头文件，既满足Firebase的模块化要求，又不破坏React Native的原有Pod配置

2. 彻底清理缓存并重新安装依赖 #

缓存问题是这类编译错误的重灾区，务必执行以下完整清理步骤：

• 清理Xcode衍生数据：打开Xcode → 顶部菜单栏Xcode → Preferences → Locations → 点击Derived Data右侧的箭头，删除整个文件夹
• 清理Pod依赖：

  cd ios
  pod deintegrate
  pod cache clean --all
  rm -rf Podfile.lock
  

• 清理Node依赖：

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

• 重新安装Pod：

  cd ios
  pod install --repo-update
  

3. 验证Xcode项目关键配置 #

• 确保你打开的是**.xcworkspace文件**，而不是.xcodeproj（错误提示里也重点提到了这点，千万别搞错）
• 检查Xcode项目的Build Settings：
  1. 搜索FRAMEWORK_SEARCH_PATHS，确保包含以下路径（缺失则添加）：

     $(inherited)
     "${PODS_ROOT}/Headers/Public"
     "${PODS_ROOT}/Headers/Public/React"
     "${PODS_ROOT}/Headers/Public/React-Core"
     

  2. 搜索HEADER_SEARCH_PATHS，确保包含React Native的核心头文件路径：

     $(inherited)
     "${PODS_ROOT}/Headers/Public/React"
     "${PODS_ROOT}/Headers/Public/React-Core"
     "${SRCROOT}/../node_modules/react-native/React"
     

4. 针对性解决剩余错误 #

如果还出现"non-modular-include-in-framework-module"错误：

• 确认你的Firebase SDK版本和React Native版本兼容（比如React Native 0.70+建议搭配Firebase 10.x+，可参考官方兼容性文档）
• 尝试在Podfile的post_install中对Firebase Target单独加强设置：

  installer.pods_project.targets.each do |target|
    if target.name.start_with?('Firebase')
      target.build_configurations.each do |config|
        config.build_settings['CLANG_ALLOW_NON_MODULAR_INCLUDES_IN_FRAMEWORK_MODULES'] = 'YES'
        config.build_settings['USE_HEADERMAP'] = 'NO'
      end
    end
  end
  

5. 极端排查方案（以上都无效时） #

• 暂时移除Firebase的Pod配置，先确保纯React Native项目能正常编译，再逐步加回Firebase模块，定位具体冲突点
• 尝试升级/降级React Native到稳定版（比如0.71+），新版本对框架链接和模块化的支持更完善
• 检查AppDelegate.m/AppDelegate.swift中的导入语句，确保没有使用非模块化的导入方式（比如#import "React/RCTBridge.h"改为#import <React/RCTBridge.h>）

如果还是有问题，可以补充你的React Native版本、Firebase版本信息，我再帮你进一步排查。

内容来源于stack exchange