Gradle构建报错：语义分析阶段异常，类文件主版本63不支持

这个错误源于JDK版本不兼容：class文件的major version 63对应JDK 17，当前运行Gradle的JDK版本无法解析该版本的class文件，或是项目配置的JDK版本与本地环境不匹配。

以下是具体解决步骤：

1. 核对JDK版本兼容性 #

• 先确认本地JDK版本：打开终端执行java -version，查看输出的版本号。
• 检查Gradle使用的JDK：查看项目根目录的gradle.properties文件，是否存在org.gradle.java.home配置，其指向的JDK路径需为17或更高版本（若项目依赖JDK17）；若无该配置，Gradle会使用系统默认JDK，需确保默认JDK版本符合要求。

2. 统一项目JDK配置 #

• 修改项目级build.gradle文件，确保编译配置与本地JDK版本一致：

android {
    compileOptions {
        sourceCompatibility JavaVersion.VERSION_17
        targetCompatibility JavaVersion.VERSION_17
    }
    // 若项目使用Kotlin，需同步配置Kotlin的JVM目标版本
    kotlinOptions {
        jvmTarget = "17"
    }
}

• 若本地JDK路径未被Gradle识别，在gradle.properties中添加指定配置：

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

（替换为你本地JDK17的实际安装路径）

3. 清理Gradle缓存 #

错误提示提到无法打开项目通用类缓存，需手动清理并重置：

• 删除指定缓存目录：C:\Users\InFED Laptop\.gradle\caches\7.5.1\scripts\cgusqz2rdd56uogb1dahk58km，也可直接删除整个.gradle/caches目录以彻底清理。
• 重启Android Studio，点击菜单栏File -> Invalidate Caches...，选择Invalidate and Restart完成缓存重置。

4. 匹配Android Gradle Plugin与Gradle版本 #

确保Android Gradle Plugin（AGP）版本与Gradle 7.5.1兼容，建议使用7.4.x或7.5.x版本的AGP，可在项目级build.gradle中检查：

plugins {
    id 'com.android.application' version '7.5.2' apply false
    id 'com.android.library' version '7.5.2' apply false
}

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