真实设备执行flutter run时出现Java版本不兼容错误

错误场景 #

在真实设备（SM A307FN）上执行flutter run启动调试模式时构建失败，核心报错：

评估':app'项目失败，应用'com.android.internal.application'插件失败，Android Gradle插件需要Java 11运行，当前使用Java 1.8。
对应构建文件：C:\flutter_application_1\android\app\build.gradle第24行

解决步骤 #

1. 先确认当前Java版本 #

• 终端执行命令：java -version，确认当前使用的是Java 1.8
• 执行flutter doctor -v，查看Flutter检测到的Java运行环境版本

2. 三种可行修复方案 #

方案一：修改Android Studio设置

打开Android Studio，依次进入：
File → Settings → Build, Execution, Deployment → Build Tools → Gradle
在Gradle JDK下拉选项中选择已安装的Java 11；若未安装，点击Download JDK...选择Java 11版本完成安装后再选择。

方案二：修改JAVA_HOME环境变量

• 找到Java 11的安装路径（Android Studio自带的Java 11路径通常为C:\Program Files\Android\Android Studio\jbr）
• 打开系统属性 → 高级 → 环境变量：
  • 修改JAVA_HOME变量值为Java 11的安装路径
  • 更新Path变量，将Java 11的bin目录（如C:\Program Files\Android\Android Studio\jbr\bin）移至最顶端
• 重启终端，执行java -version确认版本已切换为Java 11

方案三：修改项目gradle.properties文件

在项目的android/gradle.properties文件中添加或修改以下配置：

org.gradle.java.home=你的Java11安装路径

示例：

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

额外排查手段 #

• 执行flutter run --stacktrace查看详细堆栈跟踪，定位具体问题点
• 执行flutter run --info或flutter run --debug获取更多日志输出
• 执行flutter run --scan生成完整的构建分析报告

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