React Native安卓构建失败求助：Unsupported class file major version 63

核心原因 #

你遇到的错误核心是Java版本与Gradle版本不兼容：Unsupported class file major version 63对应Java 19，而你当前使用的Gradle 7.5.1不支持Java 19（Gradle 7.6及以上才开始支持Java 19）。

解决方案 #

方案1：降级Java版本到Gradle兼容版本 #

• 先确认当前Java版本：执行java -version，如果显示是Java 19，就需要降级
• 选择Gradle 7.5.1支持的Java版本（Java 8、11或17），以Java 17为例：
  • 用SDKMAN管理版本：

    sdk install java 17.0.8-amzn
    sdk use java 17.0.8-amzn
    

  • 用Homebrew（Mac）：

    brew install openjdk@17
    

    安装后需配置环境变量，把Java 17的路径加到PATH中
• 验证：再次执行java -version，确认已切换到目标版本
• 重新运行构建：npx react-native run-android

方案2：升级Gradle版本以支持Java 19 #

• 打开项目中的android/gradle/wrapper/gradle-wrapper.properties文件
• 修改distributionUrl为支持Java 19的Gradle版本，比如7.6：

  distributionUrl=https\://services.gradle.org/distributions/gradle-7.6-all.zip
  

• 保存文件后，重新执行构建命令

方案3：清理Gradle缓存（辅助修复） #

如果上面的方案执行后仍有问题，清理缓存试试：

• 删除本地Gradle缓存：

  rm -rf ~/.gradle/caches
  

• 进入项目安卓目录清理构建缓存：

  cd android && ./gradlew clean
  

• 回到项目根目录重新构建

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