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

以下是几个针对该偶发问题的验证解决方案，适合常规手段无效的场景：

• 调整Xcode构建阶段顺序
  偶发报错多和依赖构建时序有关。打开Xcode进入项目设置→Build Phases，找到[CP-User] Generate Specs脚本阶段，将其拖动到Compile Sources阶段之前，确保CodeGen生成的文件在编译前完全就绪。

• 彻底重置CodeGen与Pod依赖
  执行以下命令清理旧产物并重新生成依赖，避免版本不一致导致的异常：

  cd ios
  pod deintegrate
  rm Podfile.lock
  npx react-native codegen --clean
  npx react-native codegen
  pod install --repo-update
  

• 补充Header Search Paths配置
  在Xcode项目Build Settings中找到Header Search Paths，添加以下递归路径（确保前置$(inherited)继承默认配置）：

  $(inherited)
  $(SRCROOT)/../node_modules/react-native/React/FBReactNativeSpec
  $(SRCROOT)/../node_modules/react-native-codegen/lib
  

• 关闭Xcode并行构建
  并行构建可能引发依赖未就绪就开始编译的问题。打开Xcode→Product→Scheme→Edit Scheme→Build，取消勾选Parallelize Build选项，清理项目后重新构建。

• 重置Node.js依赖
  删除项目根目录的node_modules、package-lock.json（或yarn.lock），重新安装依赖：

  npm install # 或 yarn install
  cd ios && pod install
  

  确保所有依赖版本完全匹配，消除隐式版本冲突带来的CodeGen产物异常。

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