Flutter真机调试构建失败：Android Gradle插件需Java11当前为Java1.8

问题根因 #

当前项目使用的Android Gradle插件要求Java 11及以上版本运行环境，本地构建时实际调用的Java版本为1.8，版本不兼容导致项目评估失败，报错触发位置为项目路径下android/app/build.gradle文件第24行。

修复步骤 #

首先执行命令确认当前Flutter环境绑定的Java版本：
flutter doctor -v
查看输出中Java binary at字段对应的路径与版本号，确认版本低于11后，选择以下任意一种方案修复即可：

方案1：使用Android Studio内置JDK（推荐，操作成本最低） #

• 将本地安装的Android Studio更新至最新稳定版本，新版本会自带符合版本要求的JDK运行环境
• 打开项目下的android/gradle.properties文件，新增或修改org.gradle.java.home配置项，值填写Android Studio内置JDK的路径，Windows系统默认路径为C:\Program Files\Android\Android Studio\jbr，配置示例：

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

• 保存配置后，回到项目根目录执行flutter clean清理历史构建缓存，重新触发调试构建即可。

方案2：配置系统全局JAVA_HOME环境变量 #

• 本地提前安装好JDK 11或更高版本的JDK
• 打开Windows系统环境变量设置面板，新建系统变量JAVA_HOME，变量值填写本地安装的JDK 11+的根目录路径
• 编辑系统变量中的Path项，新增%JAVA_HOME%\bin路径，将原有旧版本Java的相关路径下移优先级或直接删除
• 保存配置后重启终端，执行java -version命令，确认输出的Java版本号为11及以上
• 回到项目根目录执行flutter clean清理缓存，重新尝试构建调试。

进阶排查手段 #

如果完成上述配置后仍存在构建问题，可以在执行构建命令时追加以下参数获取更详细的定位信息：

• 追加--stacktrace参数获取完整错误堆栈信息
• 追加--info或--debug参数输出构建全流程的详细日志
• 追加--scan参数生成完整的构建过程分析报告

内容的提问来源于stack exchange，提问作者M.Shahzad