无法运行React Native项目：Gradle构建报错求解决方案

新买了一台笔记本，配置好环境变量后创建了一个常规React Native项目，但运行时出现报错。报错信息如下：

Failed to install the app. Command failed with exit code 1: gradlew.bat tasks FAILURE: Build failed with an exception.
- What went wrong: Could not open settings generic class cache for settings file 'C:\Users\USER\Downloads\project_2\android\settings.gradle' (C:\Users\USER.gradle\caches\8.0.1\scripts\4irw9eneszvh0x724tfyer3i2). > BUG! exception in phase 'semantic analysis' in source unit '<em>BuildScript</em>' Unsupported class file major version 64
* Try: > Run with --stacktrace option to get the stack trace. > Run with --info or --debug option to get more log output. > Run with --scan to get full insights.
* Get more help at https://help.gradle.org
BUILD FAILED in 3m 22s
Downloading https://services.gradle.org/distributions/gradle-8.0.1-all.zip ...............10%................20%................30%................40%................50%................60%................70%................80%................90%................100%
Welcome to Gradle 8.0.1! Here are the highlights of this release: - Improvements to the Kotlin DSL - Fine-grained parallelism from the first build with configuration cache - Configurable Gradle user home cache cleanup
For more details see https://docs.gradle.org/8.0.1/release-notes.html
Starting a Gradle Daemon (subsequent builds will be faster).

注：此问题并非gradlew.bat installdebug问题，求解决方案。

错误原因 #

Unsupported class file major version 64 是Java版本与Gradle版本不兼容导致的：

• Class文件版本64对应Java 20
• Gradle 8.0.1仅支持Java 8至Java 17，无法识别Java 20生成的class文件

解决方案 #

• 检查当前Java版本：打开命令提示符执行 java -version，确认是否为Java 20或更高版本。
• 安装兼容的Java LTS版本：推荐安装Java 11或Java 17（长期支持版本，稳定性更强）。
• 配置Java环境：
  • 方式一（全局生效）：修改系统环境变量，将Java 11/17的安装路径设置为JAVA_HOME，并将其bin目录移至Path环境变量最前端。
  • 方式二（仅当前项目生效）：在项目的android目录下创建或编辑gradle.properties文件，添加以下内容（替换为你的Java 11/17实际路径）：

    org.gradle.java.home=C:\\Program Files\\Java\\jdk-17.0.8
    

• 清理Gradle缓存：删除C:\Users\USER\.gradle\caches目录下的所有内容，避免旧缓存残留问题。
• 重新运行项目：执行 npx react-native run-android 启动项目。

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