Flutter安装报错：‘BuildScript’语义分析阶段遇Unsupported class file major version 63异常

这个错误是因为本地Java版本（Java 19对应major version 63）和项目依赖的Android Gradle Plugin（AGP）/Gradle版本不兼容导致的——旧版本AGP不支持高版本Java，下面是几种可行的解决办法：

办法一：降低Java版本到AGP支持范围 #

• 先查项目AGP版本：打开项目根目录下的android/build.gradle，找到classpath 'com.android.tools.build:gradle:x.x.x'，其中x.x.x就是当前AGP版本
• AGP和Java版本对应关系：
  • AGP 7.0+ 支持Java 11
  • AGP 7.3+ 支持Java 17
  • AGP 8.0+ 支持Java 19
• 如果你的AGP版本低于8.0，把Java版本降到17或11即可，推荐用Java 17（兼容性更广泛）

办法二：升级AGP和Gradle版本适配Java 19 #

• 升级AGP到8.0及以上：修改android/build.gradle中的AGP依赖为classpath 'com.android.tools.build:gradle:8.0.0'（也可以用最新稳定版）
• 同步Gradle版本：AGP 8.0需要搭配Gradle 7.5及以上，修改android/gradle/wrapper/gradle-wrapper.properties里的distributionUrl=https\://services.gradle.org/distributions/gradle-7.5-bin.zip（对应版本即可）
• 执行flutter clean后重新运行项目

办法三：指定项目单独使用的Java版本（不修改全局Java） #

• 在android/app/build.gradle中添加以下配置：

  android {
      compileOptions {
          sourceCompatibility JavaVersion.VERSION_17
          targetCompatibility JavaVersion.VERSION_17
      }
      kotlinOptions {
          jvmTarget = '17'
      }
  }
  

• 确保AGP版本至少为7.3，否则还是会不兼容，必要时参照办法二升级AGP

内容的提问来源于stack exchange，提问作者Nagaraj Saravanavel