React Native iOS项目编译报错：FBReactNativeSpec脚本执行失败

运行任意React Native iOS项目时，均触发错误提示：FBReactNativeSpec : Command PhaseScriptExecution failed with a nonzero exit code。已尝试卸载重装React Native与Node.js（当前Node版本v18.14.0），问题仍未解决。

环境信息 #

System:
OS: macOS 12.6
CPU: (16) x64 Intel(R) Core(TM) i9-9880H CPU @ 2.30GHz
Memory: 196.59 MB / 16.00 GB
Shell: 5.8.1 - /bin/zsh
Binaries:
Node: 18.14.0 - /usr/local/bin/node
Yarn: 1.22.11 - /usr/local/bin/yarn
npm: 未找到
Watchman: 未找到
Managers:
CocoaPods: 1.10.2 - /usr/local/bin/pod
SDKs:
iOS SDK:
Platforms: DriverKit 22.2, iOS 16.2, macOS 13.1, tvOS 16.1, watchOS 9.1
Android SDK: 未找到
IDEs:
Android Studio: 2020.3 AI-203.7717.56.2031.7583922
Xcode: 14.2/14C18 - /usr/bin/xcodebuild
Languages:
Java: 19.0.2 - /usr/bin/javac
npmPackages:
@react-native-community/cli: 未找到
react: 17.0.2 => 17.0.2
react-native: 0.68.2 => 0.68.2
react-native-macos: 未找到
npmGlobalPackages: 无

React-Codegen Pod 配置 #

{"name":"React-Codegen","version":"0.68.2","summary":"Temp pod for generated files for React Native","homepage":"https://facebook.com/","license":"Unlicense","authors":"Facebook","compiler_flags":"-DFOLLY_NO_CONFIG -DFOLLY_MOBILE=1 -DFOLLY_USE_LIBCPP=1 -Wno-comma -Wno-shorten-64-to-32 -Wno-documentation -Wno-nullability-completeness","source":{"git":""},"header_mappings_dir":"./","platforms":{"ios":"11.0"},"source_files":"**/*.{h,mm,cpp}","pod_target_xcconfig":{"HEADER_SEARCH_PATHS":" $(PODS_ROOT)/boost $(PODS_ROOT)/RCT-Folly ${PODS_ROOT}/Headers/Public/React-Codegen/react/renderer/components $(PODS_ROOT)/Headers/Private/React-Fabric $(PODS_ROOT)/Headers/Private/React-RCTFabric"},"dependencies":{"FBReactNativeSpec":["0.68.2"],"React-jsiexecutor":["0.68.2"],"RCT-Folly":["2021.06.28.00-v2"],"RCTRequired":["0.68.2"],"RCTTypeSafety":["0.68.2"],"React-Core":["0.68.2"],"React-jsi":["0.68.2"],"ReactCommon/turbomodule/core":["0.68.2"]}}

解决办法 #

• 降级Node版本：React Native 0.68.2官方推荐Node 14.x/16.x LTS版本，v18.x存在兼容性问题。用nvm管理版本：

  nvm install 16.20.0
  nvm use 16.20.0
  

• 清理缓存与重装依赖：

  # 重置RN缓存
  npx react-native start --reset-cache
  # 清理并重装Pods
  cd ios && pod deintegrate && pod install
  # 清理node_modules并重装依赖
  cd .. && rm -rf node_modules && yarn install
  

• 检查Xcode配置：打开Xcode工程，找到FBReactNativeSpec target，进入Build Phases -> Run Script，确认脚本路径正确且执行权限正常；同时确保Xcode Command Line Tools版本与Xcode 14.2匹配。
• 更新CocoaPods：当前1.10.2版本过旧，更新到最新稳定版：

  sudo gem install cocoapods
  

• 安装Watchman：RN官方推荐安装以提升文件监听效率，可能间接解决编译问题：

  brew install watchman
  

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