React Native 构建失败：PhaseScriptExecution 错误解决方案
2021-03-22 创建，2021-03-25 编辑，100 个赞
问题描述
在使用 React Native 进行 iOS 开发时，许多开发者遇到了相同的构建错误：PhaseScriptExecution [CP-User] Generate Specs 失败。这个错误通常出现在新创建的项目中，执行 react-native run-ios 命令时。
典型的错误信息显示在 Xcode 构建过程中，特别是在处理 FlipperKit 和相关依赖时出现编译错误，最终导致脚本执行阶段失败。
根本原因分析
这个问题的根源多样，但主要涉及以下几个方面：
- 路径中包含空格：项目路径或父级文件夹名称包含空格字符
- Node.js 环境配置问题：特别是使用 nvm 管理 Node 版本时的兼容性问题
- 架构兼容性问题：Apple M1 芯片与 Intel 芯片的环境差异
- Flipper 版本兼容性：React Native 与 Flipper 调试工具的版本不匹配
解决方案
根据社区的大量反馈，以下是经过验证的有效解决方案，请按顺序尝试：
方案一：移除路径中的空格（最常见解决方案）
确保项目路径中不包含任何空格字符：
# 错误示例（包含空格）：
/Users/username/React Native Projects/MyApp
# 正确示例（使用连字符或下划线）：
/Users/username/React-Native-Projects/MyApp操作步骤：
- 将项目移动到不含空格的路径中
- 删除
ios/Pods文件夹和Podfile.lock文件 - 重新运行
pod install和react-native run-ios
方案二：修复 Node.js 环境路径
如果使用 nvm 管理 Node 版本，可能会遇到路径解析问题：
# 创建符号链接确保系统能找到 node
sudo ln -s $(which node) /usr/local/bin/node
# 或者在 ~/.zshrc 或 ~/.bash_profile 中添加
echo 'export PATH="/usr/local/bin:$PATH"' >> ~/.zshrc对于 React Native 0.70+ 版本，检查并更新 ios/.xcode.env.local 文件：
# 查看 node 的实际路径
which node
# 更新 NODE_BINARY 变量
export NODE_BINARY="/opt/homebrew/bin/node" # M1 芯片典型路径
# 或
export NODE_BINARY="/usr/local/bin/node" # Intel 芯片典型路径方案三：M1 芯片特殊配置
对于 Apple M1 芯片用户，需要确保所有工具在 Rosetta 模式下运行：
- 终端应用：右键点击 Finder 中的终端应用 → 获取信息 → 使用 Rosetta 打开
- Homebrew：安装 x86 版本而非 ARM 版本
- 检查工具路径：
# 正确路径（x86 版本）
which node # 应该显示 /usr/local/homebrew/bin/node
which yarn # 应该显示 /usr/local/homebrew/bin/yarn
which pod # 应该显示 /usr/local/homebrew/bin/pod
# 错误路径（ARM 版本，可能导致问题）
/opt/homebrew/bin/node方案四：修改 Podfile 配置
更新 ios/Podfile 中的 Flipper 配置指定版本：
use_flipper!({
'Flipper-Folly' => '2.5.3',
'Flipper' => '0.87.0',
'Flipper-RSocket' => '1.3.1'
})然后重新安装 pods：
cd ios
rm -rf Pods Podfile.lock
pod install方案五：清理缓存和衍生数据
彻底清理构建缓存：
# 清理 Node 模块和缓存
rm -rf node_modules
yarn cache clean
npm cache clean --force
# 清理 iOS 构建缓存
cd ios
rm -rf Pods Podfile.lock
rm -rf ~/Library/Developer/Xcode/DerivedData/*
# 重新安装依赖
yarn install
cd ios && pod install && cd ..方案六：禁用或修改 find-node.sh 脚本
对于高级用户，可以修改 React Native 的节点查找脚本：
编辑 node_modules/react-native/scripts/find-node.sh，注释掉 nvm 相关代码：
# 注释以下代码段：
# if [[ -s "$HOME/.nvm/nvm.sh" ]]; then
# . "$HOME/.nvm/nvm.sh"
# elif [[ -x "$(command -v brew)" && -s "$(brew --prefix nvm)/nvm.sh" ]]; then
# . "$(brew --prefix nvm)/nvm.sh"
# fiWARNING
此方案需要每次安装 node_modules 后重新应用，建议使用 patch-package 持久化修改
预防措施
- 项目初始化：始终使用
npx react-native init ProjectName而非全局 CLI - 路径规划：确保项目路径不含空格和特殊字符
- 版本一致性：保持 Node.js、React Native 和 CocoaPods 版本兼容
- 文档参考：创建项目时记录使用的版本信息，便于后续排查问题
总结
PhaseScriptExecution 错误通常与环境配置相关而非代码本身问题。通过系统性地检查路径、Node.js 环境和平台特定配置，大多数情况下可以解决此问题。建议从最简单的"移除路径空格"方案开始尝试，逐步排查到更复杂的环境配置问题。
INFO
如果所有方案都无效，考虑创建全新的 React Native 项目，逐步迁移代码，这往往比修复复杂的环境问题更高效。