React Native项目运行报错：执行node命令失败，找不到node程序

问题现象 #

构建时触发如下错误：

:ReactNative:执行 '[node, -e, console.log(require('react-native/cli').bin);]' 命令失败。

FAILURE: 构建因异常失败。

• 位置：脚本 '/Users/test/Documents/testA/react/app-test/test/node_modules/@react-native-community/cli-platform-android/native_modules.gradle' 第179行
• 错误原因：脚本评估时出现问题。

  无法运行程序 "node"（目录 "/Users/test/Documents/testA/react/app-test/test/android"）：error=2, 没有该文件或目录

解决方法 #

1. 验证Node.js的安装与环境变量 #

• 打开终端执行 node -v，如果无法输出版本号，先安装Node.js。
• 执行 echo $PATH 检查输出中是否包含Node.js的安装路径（通常是/usr/local/bin或nvm管理的路径如~/.nvm/versions/node/<版本号>/bin）。
• 如果使用nvm，确认~/.bashrc或~/.zshrc中包含nvm的初始化脚本（比如source ~/.nvm/nvm.sh），并重启终端生效。

2. 直接给Gradle指定Node.js路径 #

在项目的android/gradle.properties文件末尾添加以下配置，替换成你的Node.js绝对路径：

org.gradle.node.executable=/你的/node/绝对路径

示例（nvm安装的情况）：

org.gradle.node.executable=~/.nvm/versions/node/v18.17.0/bin/node

3. 清理缓存并重试构建 #

执行以下命令清理项目缓存后重新构建：

cd android
./gradlew clean
cd ..
npx react-native run-android

4. 重启开发环境 #

修改环境变量或Gradle配置后，重启终端和Android Studio（或你使用的IDE），确保新配置被加载。

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