React Native iOS项目构建失败：部署目标配置与Node环境报错

首次构建异常处理（低版本部署目标告警、Flipper代码编译中断、签名配置占位） #

• 修正Pods全局部署目标兼容问题：不要手动逐个修改Pods项目下各target的部署参数，这类手动修改的配置会在下次执行pod install时被覆盖。直接打开项目下的ios/Podfile，在文件顶部的依赖引入行之后添加全局配置钩子，强制所有Pods的编译目标对齐当前Xcode支持的版本范围，从根源上消除boost-for-react-native、YogaKit等组件的8.0/8.4低版本告警：

platform :ios, '13.0'
post_install do |installer|
  installer.pods_project.targets.each do |target|
    target.build_configurations.each do |config|
      config.build_settings['IPHONEOS_DEPLOYMENT_TARGET'] = '13.0'
      config.build_settings['ARCHS'] = `uname -m`
      config.build_settings['ONLY_ACTIVE_ARCH'] = 'YES' if config.name == 'Debug'
    end
  end
end

• 彻底解决Flipper编译中断问题：仅注释Podfile中的use_flipper!()行无法完全移除Flipper关联组件，需要同步删除Podfile中所有和Flipper相关的依赖引用、配套的Flipper-PeerTalk、Flipper-Glog等适配配置行。修改完成后，删除项目下的ios/Pods文件夹、ios/Podfile.lock锁文件、根目录的node_modules依赖目录，再重新执行pod install，避免残留的Flipper编译缓存触发FlipperRSocketResponder.cpp编译报错。
• 修正签名配置占位问题：打开ios/AwesomeProject.xcodeproj，在项目的Signing & Capabilities配置页，为Debug、Release构建配置勾选自动管理签名，选择实际的开发团队替换系统默认的占位团队ID，避免后续运行出现签名校验失败。

二次构建异常处理（FBReactNativeSpec脚本Node识别失败、PhaseScriptExecution非零退出） #

这类报错的核心原因是Xcode的编译脚本环境无法继承iTerm中配置的nvm路径，导致脚本检索Node时返回空值，进而提示需要安装N/A版本的Node，和本地Node是否正常安装无关。

• 先在iTerm终端执行which node，记录输出的Node实际安装绝对路径（通常为nvm目录下的版本路径，如/Users/xxx/.nvm/versions/node/v18.x.x/bin/node）
• 打开Xcode项目配置页，找到Build Phases标签下的Bundle React Native code and images、Start Packager两个编译脚本，将脚本内默认的export NODE_BINARY=node替换为刚才记录的Node绝对路径，强制脚本指向正确的可执行文件。
• 配置持久化的路径软链：执行ln -s $(which node) /usr/local/bin/node，将nvm安装的Node链接到系统全局可执行目录，避免后续每次重新生成项目脚本时都出现路径识别失败的问题。
• 清理所有本地编译缓存后重新构建：先执行npx react-native start --reset-cache重置Metro服务缓存，再重新运行npx react-native run-ios完成构建。

内容的提问来源于stack exchange，提问作者M-WRI