React Native运行Android报错：Unsupported class file major version 64

问题场景 #

执行npx react-native run-android时，JS服务器、模拟器均正常启动，但应用安装环节构建失败，核心报错信息：

无法打开设置文件C:\react native\New folder (2)\MyProject\android\settings.gradle的通用类缓存；在_BuildScript_源单元的'semantic analysis'阶段出现异常，提示“Unsupported class file major version 64”

错误原因 #

Unsupported class file major version 64是Java版本不兼容导致的：该版本号对应Java 20，而当前项目使用的Gradle或Android Gradle Plugin（AGP）版本不支持这么高的Java版本。

解决方案 #

1. 检查当前Java版本
   打开终端执行：

   java -version
   

   确认是否为Java 20及以上版本。

2. 降级Java到兼容版本
   React Native 0.70+推荐使用Java 17，低版本RN推荐Java 11：

   • 安装对应版本的JDK
   • 配置系统环境变量：
     • 设置JAVA_HOME指向新JDK的安装路径
     • 将JDK的bin目录添加到PATH环境变量最前端，确保优先级最高

3. 验证Java版本切换
   重启终端后再次执行java -version，确认版本已切换到目标JDK。

4. 清理缓存并重试构建

   • 删除项目根目录下的.gradle文件夹
   • 进入android目录执行清理命令：

     # Windows
     gradlew clean
     # macOS/Linux
     ./gradlew clean
     

   • 返回项目根目录重新执行：

     npx react-native run-android
     

可选：项目级指定JDK版本（无需全局修改） #

如果不想调整全局Java版本，可在项目的android/gradle.properties文件中添加以下配置（替换为你的JDK路径）：

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

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