React Native新建项目报错：JAVA_HOME未配置或无java命令求助

问题描述 #

我是React Native新手，尝试创建新项目时遇到如下报错：

Please set the JAVA_HOME variable in your environment to match the
location of your Java installation.

error Failed to install the app. Make sure you have the Android development environment set up: https://reactnative.dev/docs/environment-setup.
Error: Command failed: gradlew.bat app:installDebug -PreactNativeDevServerPort=8081

我已配置环境变量，但问题仍存在，请求帮助。

环境变量配置截图 #

• 系统变量配置
• 用户变量配置

排查解决步骤 #

• 确认JAVA_HOME路径有效性：检查JAVA_HOME指向的C:\Program Files\Java\jdk1.8.0_381是否真实存在，打开命令提示符执行echo %JAVA_HOME%验证输出，再执行java -version和javac -version确认JDK可正常调用。
• 重启终端/电脑：环境变量配置后需重启终端或电脑，确保新变量加载生效，这是最容易忽略的点。
• 检查Path变量：确认系统变量和用户变量的Path中都添加了%JAVA_HOME%\bin，无拼写错误。
• 对齐Android Studio JDK配置：打开Android Studio，进入File > Project Structure > SDK Location，确保JDK location与JAVA_HOME一致，或选择使用Android Studio内置JDK（此时需将JAVA_HOME指向内置JDK路径，如Android Studio安装目录\jbr）。
• 校验gradle与JDK兼容性：查看项目android\gradle\wrapper\gradle-wrapper.properties中的gradle版本，JDK 8需搭配gradle 4.x-6.x，JDK 11搭配gradle 7.x及以上，版本不兼容则更换对应版本。
• 清理缓存重试：执行以下命令清理缓存后重新运行项目：

  cd 项目目录
  npx react-native clean
  cd android
  gradlew clean
  npx react-native run-android
  

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