React Native毕设执行npm run android命令时遇Gradle构建错误求助

错误核心原因 #

Unsupported class file major version 63 本质是Java版本与Gradle版本不兼容：你当前使用的Java 19（class文件版本标识为63），而项目依赖的Gradle 7.5.1不支持Java 19，导致构建时无法解析类文件。

可行解决方案 #

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

Gradle 7.5.1支持Java 8/11/17，推荐切换到Java 11或17：

• 安装对应版本的JDK，确保系统JAVA_HOME环境变量指向该JDK路径
• 配置项目Java版本：
  1. 修改android/build.gradle：

     buildscript {
         ext {
             // 保留原有配置，新增Java版本指定
             javaVersion = JavaVersion.VERSION_11 // 或 VERSION_17
         }
         // ... 其他原有代码
     }
     

  2. 修改android/app/build.gradle：

     android {
         // ... 其他原有代码
         compileOptions {
             sourceCompatibility JavaVersion.VERSION_11
             targetCompatibility JavaVersion.VERSION_11
         }
         kotlinOptions {
             jvmTarget = "11"
         }
     }
     

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

若不想降级Java，可升级Gradle到7.6及以上（该版本开始支持Java 19）：

• 修改android/gradle/wrapper/gradle-wrapper.properties中的distributionUrl：

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

• 同步Gradle插件版本到适配7.6的版本（如7.4.2），修改android/build.gradle：

  buildscript {
      dependencies {
          classpath("com.android.tools.build:gradle:7.4.2")
          // ... 其他原有依赖
      }
  }
  

方案3：清理Gradle缓存（辅助步骤）

缓存损坏也可能触发此类错误，执行以下命令清理后重试：

# Windows系统执行
gradlew clean
del /s /q C:\Users\Sharjil\.gradle\caches

完成以上操作后，重新运行npm run android即可尝试构建。

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