React Native iOS运行报错：xcodebuild命令退出码66求助

问题场景 #

React Native应用在Android设备上运行完全正常，但iOS端执行npx react-native run-ios时触发错误：

"xcodebuild" command but it exited with error code 66

环境版本：

• nodeJS v16.16.0
• npm v8.11.0
• pod v1.11.3

操作流程：克隆GitHub仓库 → npm i安装依赖 → 进入iOS目录执行pod install → 启动Metro（npx react-native start） → 运行iOS应用触发错误。

可行解决方案 #

• 检查Xcode命令行工具配置
  打开Xcode的「偏好设置」→「位置」，确认「命令行工具」选择了当前安装的Xcode版本。也可通过终端验证：

  xcode-select --print-path
  

  若路径不正确，执行以下命令切换：

  sudo xcode-select --switch /Applications/Xcode.app/Contents/Developer
  

• 彻底清理iOS构建缓存
  执行以下命令清除所有相关缓存后重新构建：

  # 清理React Native全局缓存
  npx react-native clean
  # 进入iOS目录清理pod与构建文件
  cd ios
  pod deintegrate
  pod clean
  rm -rf Podfile.lock
  rm -rf build
  # 重新安装pod依赖
  pod install
  

  返回项目根目录后，重启Metro服务，再执行npx react-native run-ios。

• 检查签名与证书配置
  Error code 66多数和签名配置相关。打开iOS目录下的项目名.xcworkspace文件，在Xcode中选择项目target →「Signing & Capabilities」：

  • 确保「Automatically manage signing」已勾选
  • 确认Team选项选择了有效的开发者团队，且证书未过期
  • 若使用测试设备，检查设备是否已添加到开发者账号的设备列表中

• 验证第三方依赖兼容性
  排查项目中的第三方原生模块是否存在iOS版本兼容问题。可尝试将相关依赖更新到最新稳定版本，或查看依赖的GitHub Issues页面，确认是否有其他开发者遇到相同问题并给出解决方案。

• 确认Xcode与React Native版本兼容
  查看React Native官方文档的版本兼容矩阵，确保当前Xcode版本与项目使用的React Native版本匹配。若Xcode版本过低，建议升级至对应兼容版本；若版本过高，可考虑降级Xcode或更新React Native到适配版本。

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