iOS构建时React-Codegen PhaseScriptExecution失败求助

我是Mac和React Native环境的新手，尝试编译React Native iOS项目时遭遇构建失败，错误与React-Codegen相关。具体错误信息如下：

The following build commands failed:
    PhaseScriptExecution [CP-User]\ Generate\ Specs /Users/jack/Library/Developer/Xcode/DerivedData/PHSS-gbhmkidqifcietcaoiomzormheri/Build/Intermediates.noindex/Pods.build/Debug-iphonesimulator/React-Codegen.build/Script-46EB2E0001F8B0.sh (in target 'React-Codegen' from project 'Pods')

Building workspace PHSS with scheme PHSS and configuration Debug.

#!/bin/sh
pushd "$PODS_ROOT/../" > /dev/null
RCT_SCRIPT_POD_INSTALLATION_ROOT=$(pwd)
popd >/dev/null

export RCT_SCRIPT_RN_DIR=$RCT_SCRIPT_POD_INSTALLATION_ROOT/../node_modules/react-native
export RCT_SCRIPT_APP_PATH=$RCT_SCRIPT_POD_INSTALLATION_ROOT/..
export RCT_SCRIPT_OUTPUT_DIR=$RCT_SCRIPT_POD_INSTALLATION_ROOT
export RCT_SCRIPT_TYPE=withCodegenDiscovery

SCRIPT_PHASES_SCRIPT="$RCT_SCRIPT_RN_DIR/scripts/react_native_pods_utils/script_phases.sh"
WITH_ENVIRONMENT="$RCT_SCRIPT_RN_DIR/scripts/xcode/with-environment.sh"
/bin/sh -c "$WITH_ENVIRONMENT $SCRIPT_PHASES_SCRIPT"

环境配置 #

• react-native-cli: 2.0.1
• Node Version: v20.19.0
• yarn: 1.22.22
• Xcode 16.2（Build version 16C5032a）
• CocoaPods Version: 1.16.2
• macOS: 15.3.1（BuildVersion: 24D70）
• 架构: Apple M2

排查修复步骤 #

1. 清理依赖缓存并重装
   • 删除项目根目录的node_modules文件夹：rm -rf node_modules
   • 清除yarn缓存：yarn cache clean
   • 重新安装依赖：yarn install
2. 重置CocoaPods配置
   • 切换到ios目录：cd ios
   • 删除Pods文件夹和Podfile.lock文件：rm -rf Pods Podfile.lock
   • 更新Pod仓库并重新安装：pod install --repo-update
3. 清理Xcode构建缓存
   • 打开Xcode，使用快捷键Cmd+Shift+K清理当前项目的构建文件夹
   • 删除全局DerivedData缓存：rm -rf ~/Library/Developer/Xcode/DerivedData
4. 验证Node版本兼容性
   • React Native部分版本对Node v20的兼容性有待优化，可尝试切换到v18.x LTS版本（借助nvm管理：nvm install 18 && nvm use 18）
5. 检查React-Codegen相关脚本路径
   • 确认node_modules/react-native/scripts/react_native_pods_utils/script_phases.sh和with-environment.sh文件存在，若缺失说明依赖安装不完整，重新执行依赖安装步骤

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