Flutter项目部署至手机失败：Gradle类版本兼容问题求助

命令行操作及报错信息 #

PS D:\app> flutter clean                                             .0s
Deleting .dart_tool...
8ms
Deleting Generated.xcconfig...
1ms
Deleting flutter_export_environment.sh...
1ms
Deleting ephemeral...
2ms
PS D:\app> flutter run
Running "flutter pub get" in app...
Resolving dependencies...
characters 1.2.1 (1.3.0 available)
collection 1.17.0 (1.17.1 available)
js 0.6.5 (0.6.7 available)
matcher 0.12.13 (0.12.14 available)
meta 1.8.0 (1.9.0 available)
path 1.8.2 (1.8.3 available)
test_api 0.4.16 (0.4.18 available)
Got dependencies!
Launching lib\main.dart on moto g 5G in debug mode...

构建失败异常 #

FAILURE: Build failed with an exception.

• 问题原因：
  无法为设置文件'D:\app\android\settings.gradle'打开设置通用类缓存（路径：C:\Users\karth.gradle\caches\7.5\scripts\3d075fs9hjp81ny0sgym4v09w）。

BUG! 源单元'_BuildScript'的'semantic analysis'阶段出现异常：Unsupported class file major version 63

• 建议尝试：
  运行时添加--stacktrace选项获取堆栈跟踪。
  添加--info或--debug选项获取更多日志输出。
  添加--scan选项获取完整分析信息。

BUILD FAILED in 40s
Running Gradle task 'assembleDebug'... 41.5s
Exception: Gradle task assembleDebug failed with exit code 1

已尝试的解决方法 #

• 删除项目根目录的.gradle文件夹：
  Windows：rd /s /q .gradle
  Linux/Mac：rm -rf .gradle
  之后重新运行flutter run。
• 通过Android Studio清理缓存并重启：

  打开Android Studio加载Flutter项目
  进入File > Invalidate Caches / Restart
  点击"Invalidate and Restart"按钮
  重启后执行`flutter clean`，再重新运行`flutter run`
  

新增解决方案 #

方案1：切换项目使用的Java版本至17或更低 #

class file major version 63对应Java 19，而当前使用的Gradle 7.5不支持Java 19，需降级Java版本：

• 打开Android Studio，进入File > Project Structure > SDK Location，查看当前JDK版本，若高于17，下载安装Java 17并切换到该JDK
• 也可在项目的android/gradle.properties中直接指定JDK路径：

  org.gradle.java.home=C:/Program Files/Java/jdk-17.0.8
  

• 检查系统环境变量JAVA_HOME，确保其指向Java 17或更低版本，重启终端后执行java -version确认版本

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

Gradle 7.6及以上版本支持Java 19，可升级项目的Gradle配置：

1. 打开android/build.gradle，修改gradle插件版本：

   dependencies {
       classpath 'com.android.tools.build:gradle:7.6.0'
       classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:$kotlin_version"
   }
   

2. 打开android/gradle/wrapper/gradle-wrapper.properties，修改distributionUrl：

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

3. 执行flutter clean后重新运行flutter run

方案3：清理全局Gradle缓存 #

删除用户目录下的全局Gradle缓存（C:\Users\karth\.gradle\caches），之后重新运行项目，让Gradle重新下载适配的依赖和缓存文件

内容的提问来源于stack exchange，提问作者Cyber Karthik