更新Android Studio后遇Unsupported class file major version 63构建错误

问题本质 #

类文件主版本63对应JDK 17，当前项目使用的Gradle 7.4不支持JDK 17（Gradle 7.x系列仅7.5及以上版本兼容JDK 17），导致构建脚本的类缓存无法正常加载，触发语义分析阶段异常。

具体解决步骤 #

方案1：降级JDK版本至Gradle兼容范围 #

• 打开Android Studio，依次进入 File > Project Structure > SDK Location
• 在「JDK Location」选项中选择JDK 11或JDK 8（Gradle 7.4官方兼容的JDK版本）
• 也可直接在项目根目录的gradle.properties文件中添加配置：

  org.gradle.java.home=你的JDK11/8安装路径
  

• 同步项目后重新执行构建

方案2：升级Gradle版本以支持JDK 17 #

若希望继续使用JDK 17，需将Gradle版本升级至7.5及以上：

• 打开项目根目录下的gradle/wrapper/gradle-wrapper.properties文件
• 修改distributionUrl字段为对应版本的Gradle下载链接，例如：

  distributionUrl=https\://services.gradle.org/distributions/gradle-7.5-bin.zip
  

• 同步项目，Android Studio会自动下载并配置该版本Gradle

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

• 删除路径 C:\Users\ARC\.gradle\caches\7.4 下的所有缓存文件（或直接删除整个.gradle/caches目录）
• 重启Android Studio后再次尝试构建

原错误信息 #

构建文件 'D:\StudioProjects\untitled1\android\build.gradle' 第26行出现错误：
【问题原因】
评估根项目 'android' 时发生问题。

配置项目 ':app' 时发生问题。
无法打开构建文件 'D:\StudioProjects\untitled1\android\app\build.gradle' 的通用类缓存（路径：C:\Users\ARC.gradle\caches\7.4\scripts\5j806ry1k8j18kre88jnws39s）。

错误！在源单元 'BuildScript' 的 '语义分析' 阶段出现异常：不支持的类文件主版本63

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