Expo项目EAS构建报错：'React/RCTBridge+Private.h'文件未找到

解决方案步骤 #

1. 彻底重置本地依赖与缓存 #

• 清除Expo项目缓存：expo r -c
• 删除node_modules、package-lock.json（或yarn.lock），重新安装依赖：npm install（或yarn install）
• 针对iOS环境，清除Pod缓存并重新集成：

  pod cache clean --all
  cd ios && pod deintegrate && pod install && cd ..
  

2. 强制匹配SDK 46对应的依赖版本 #

SDK 46对部分核心开发工具包有严格版本要求，需确保package.json中以下依赖版本正确：

• expo-dev-menu: ~1.2.1
• expo-dev-launcher: ~1.3.1
• expo-updates: ~0.14.7

修改后重新执行依赖安装，避免版本不兼容导致的头文件引用异常。

3. 调整Podfile配置，修复头文件路径 #

在ios/Podfile的post_install钩子中添加针对expo-dev-menu的头文件路径配置，确保React私有头文件能被正确检索：

post_install do |installer|
  installer.pods_project.targets.each do |target|
    if target.name == 'expo-dev-menu'
      target.build_configurations.each do |config|
        config.build_settings['HEADER_SEARCH_PATHS'] ||= ['$(inherited)']
        config.build_settings['HEADER_SEARCH_PATHS'] << '"$(SRCROOT)/../node_modules/react-native/React"'
      end
    end
  end
end

修改完成后重新执行cd ios && pod install。

4. 对齐EAS构建环境与本地环境 #

在eas.json中指定与本地一致的Node.js版本，避免环境差异引发的构建问题：

{
  "build": {
    "production": {
      "node": "16.x"
    }
  }
}

建议先执行eas build --local在本地模拟云端构建流程，提前排查潜在问题。

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