Flutter项目编译失败：Android Gradle插件要求Java17，当前使用Java11

问题描述 #

我的项目基于Flutter框架，使用Dart语言开发，数据库采用Firebase，开发环境为Windows系统下的Android Studio。根据报错信息，项目当前使用Java 11，但我检查项目配置、gradle.properties及项目结构后，确认已设置为Java 17。修改Java版本后问题仍未解决，但新建的测试项目可正常运行。执行main.dart文件后出现如下编译错误：

FAILURE: 构建失败，出现异常。

* 位置: 构建文件 'D:\flutter project\my_app\android\app\build.gradle' 第24行

* 出错原因: 评估项目 ':app' 时出现问题。
> 无法应用插件 'com.android.internal.application'。
   > Android Gradle插件需要Java 17才能运行。您当前使用的是Java 11。
      您当前的JDK位于 C:\Program Files\Android\Android Studio\jre
      您可以尝试以下几种解决办法：
       - 修改IDE设置。
       - 修改JAVA_HOME环境变量。
       - 修改gradle.properties中的org.gradle.java.home配置。

* 尝试方案:
> 使用 --stacktrace 参数运行以获取堆栈跟踪信息。
> 使用 --info 或 --debug 参数运行以获取更多日志输出。
> 使用 --scan 参数运行以获取完整分析报告。
> 访问 https://help.gradle.org 获取更多帮助。

构建失败，耗时30秒 异常: Gradle任务assembleDebug执行失败，退出码为1

解决步骤 #

1. 修正Android Studio的JDK配置 #

• 打开Android Studio，依次进入File > Settings > Build, Execution, Deployment > Build Tools > Gradle
• 在Gradle JDK选项中，选择Java 17版本（若未安装，点击Download JDK下载对应版本）
• 保存设置并重启IDE

2. 调整gradle.properties配置 #

• 打开项目根目录下的gradle.properties文件，添加或修改以下配置：

  org.gradle.java.home=C:\\Program Files\\Android\\Android Studio\\jbr
  

  注意：Android Studio Arctic Fox及以上版本自带的JDK路径为jbr而非旧版的jre，这是常见的配置误区

3. 更新系统环境变量 #

• 右键此电脑 > 属性 > 高级系统设置 > 环境变量
• 在系统变量中找到JAVA_HOME，将其值修改为Java 17的安装路径（如C:\Program Files\Android\Android Studio\jbr）
• 重启终端和Android Studio，确保环境变量生效

4. 检查Gradle插件兼容性 #

• 打开android/build.gradle文件，确认Gradle插件版本与Java 17兼容（建议使用7.0及以上版本）：

  dependencies {
      classpath 'com.android.tools.build:gradle:7.4.2'
      // 其他依赖配置
  }
  

5. 清理重建项目 #

• 在Android Studio中执行Build > Clean Project，再执行Build > Rebuild Project
• 或在终端运行以下命令：

  flutter clean
  flutter pub get
  flutter run
  

内容的提问来源于stack exchange，提问作者SANCHITA CHOWDHURY