React Native安卓正常iOS编译报错：'React/RCTBridgeModule.h'文件未找到

问题场景 #

维护一个2年前开发的React Native应用，Android端构建正常，但iOS端执行pod install后，用Xcode编译时出现两个错误：

• 'React/RCTBridgeModule.h' file not found（词法/预处理器错误）
• Cannot find protocol declaration for 'RCTInitializing'

已尝试的操作：

• 清除node_modules缓存或删除后重新安装
• 删除Pods目录后重新执行pod install，打开.xcworkspace清理项目后重建
• 统一所有Pod文件与项目的iOS编译目标

环境信息：

• Xcode版本：12.0(12A7209)
• react："17.0.1"
• react-native："0.63.4"

解决步骤 #

1. 修复Podfile的重复依赖与配置问题 #

你的Podfile存在重复引入依赖（如react-native-google-maps和react-native-maps重复添加），且全局use_modular_headers!可能与旧第三方库兼容冲突，修改后的Podfile如下：

require_relative '../node_modules/react-native/scripts/react_native_pods'
require_relative '../node_modules/@react-native-community/cli-platform-ios/native_modules'

platform :ios, '11.0'

target 'MyAppName' do
  # 改用静态链接的use_frameworks!，避免全局modular headers导致的兼容问题
  use_frameworks! :linkage => :static

  # RNPermissions相关依赖
  pod 'RNPermissions', :path => '../node_modules/react-native-permissions'
  permissions_path = '../node_modules/react-native-permissions/ios'
  pod 'Permission-Camera', :path => "#{permissions_path}/Camera"
  pod 'Permission-LocationAlways', :path => "#{permissions_path}/LocationAlways"
  pod 'Permission-LocationWhenInUse', :path => "#{permissions_path}/LocationWhenInUse"
  pod 'Permission-Notifications', :path => "#{permissions_path}/Notifications"
  pod 'Permission-PhotoLibrary', :path => "#{permissions_path}/PhotoLibrary"
  pod 'Permission-Microphone', :path => "#{permissions_path}/Microphone"  

  # React Native Maps - 移除重复引入
  rn_maps_path = '../node_modules/react-native-maps'
  pod 'react-native-maps', :path => rn_maps_path
  pod 'GoogleMaps'
  pod 'Google-Maps-iOS-Utils'

  # Firebase相关
  pod 'Firebase/Core'
  pod 'Firebase/Messaging'

  use_react_native!(
    :hermes_enabled => false
  )

  pod 'ReactNativeExceptionHandler', :path => '../node_modules/react-native-exception-handler'
  pod 'RNSVG', :path => '../node_modules/react-native-svg'

  target 'MyAppNameTests' do
    inherit! :complete
  end

  post_install do |installer|
    react_native_post_install(installer)
    # 给第三方库添加React头文件搜索路径，适配Xcode 12
    installer.pods_project.targets.each do |target|
      target.build_configurations.each do |config|
        config.build_settings['HEADER_SEARCH_PATHS'] ||= "$(inherited) $(SRCROOT)/../node_modules/react-native/**"
      end
    end
  end
end

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

执行以下命令，彻底清除所有缓存和旧依赖：

# 清理node_modules和npm缓存
rm -rf node_modules
npm cache clean --force
npm install

# 切换到iOS目录清理Pods
cd ios
rm -rf Pods Podfile.lock
rm -rf ~/Library/Caches/CocoaPods
rm -rf ../node_modules/.cache
pod deintegrate
pod install

3. 调整Xcode项目配置 #

打开MyAppName.xcworkspace，按以下步骤操作：

• 选中项目target，进入Build Settings标签页
• 搜索Header Search Paths，添加$(SRCROOT)/../node_modules/react-native/React，并设置为recursive
• 确保Framework Search Paths包含$(inherited)和$(SRCROOT)/Pods/Headers/Public
• 执行Product > Clean Build Folder（快捷键Cmd+Shift+K）清理编译缓存
• 重新编译项目：Product > Build（Cmd+B）

4. 检查第三方库版本兼容性 #

确认以下库的版本与react-native 0.63.4兼容：

• react-native-permissions：建议使用^3.0.0版本
• react-native-maps：建议使用^0.27.1版本
• 若使用react-native-firebase，需对应v10.x版本

如果版本不匹配，修改package.json后重新执行npm install和pod install。

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