本文详解 Flutter 项目构建时出现 “java.exe not found” 错误（如 The supplied javaHome seems to be invalid）的根本原因与实操解决步骤，涵盖 JDK 配置、Android Studio 内置 JRE 兼容性问题、环境变量校验及 Flutter 工具链修复方法。

本文详解 flutter 项目构建时出现 “java.exe not found” 错误（如 `the supplied javahome seems to be invalid`）的根本原因与实操解决步骤，涵盖 jdk 配置、android studio 内置 jre 兼容性问题、环境变量校验及 flutter 工具链修复方法。

在使用 Flutter 开发 Android 应用时，执行 flutter build apk 或运行 flutter run 常会遇到如下构建失败错误：

FAILURE: Build failed with an exception.
* What went wrong:
The supplied javaHome seems to be invalid. I cannot find the java executable.
Tried location: C:Program FilesAndroidAndroid Studiojreinjava.exe

该错误并非单纯因 JAVA_HOME 未设置，而多源于 Android Studio 自带的 JRE（尤其在新版 AS 中已移除或精简 JRE）不再提供完整可执行的 java.exe，导致 Gradle 无法定位有效 JDK。

✅ 正确解决方案如下（经验证适用于 Android Studio Giraffe/Flamingo + Flutter 3.10+）：

1. 安装独立 JDK（推荐 OpenJDK 17）

Flutter 官方推荐并兼容 JDK 17（非 JDK 21+，避免 Gradle 兼容问题）：

• 下载 Eclipse Temurin JDK 17（LTS 版本，Windows x64 MSI 安装包）
• 安装路径建议使用无空格、无中文的目录，例如：C:devjdk-17.0.1

2. 正确配置 JAVA_HOME 环境变量

• 变量名：JAVA_HOME
• 变量值：C:devjdk-17.0.1（⚠️ 不要加 in！仅指向 JDK 根目录）
• 将 %JAVA_HOME%in 添加到 Path 环境变量中
• 验证：终端执行 java -version 和 echo %JAVA_HOME%，确保输出一致且版本为 17.x

3. 告知 Flutter/Gradle 使用该 JDK

在 Flutter 项目根目录下，编辑或创建文件 android/gradle.properties，添加或修正以下行：

OpenJDK 24

下载

org.gradle.java.home=C:\dev\jdk-17.0.1

✅ 注意：路径使用双反斜杠 \ 或正斜杠 /（如 C:/dev/jdk-17.0.1），避免单反斜杠转义问题；不要引用 Android Studio 的 jre 路径（新版 AS 已弃用内置 JRE）。

4. 清理并重建（关键步骤）

执行以下命令彻底清除缓存，避免旧配置干扰：

flutter clean
flutter pub get
cd android && ./gradlew clean && cd ..
flutter build apk --release

? 补充提示：

• 若使用 VS Code，请重启终端或整个编辑器以加载新环境变量；
• 在 Android Studio 中，还需进入 File > Project Structure > SDK Location，手动将 JDK location 指向 C:devjdk-17.0.1；
• 避免混用多个 JDK 版本——Flutter、Gradle、Android Studio 应统一使用同一 JDK 17 实例。

通过以上四步，99% 的 java.exe not found 构建错误可被根治。核心原则是：弃用 AS 自带 JRE，改用标准、完整、受支持的 JDK 17，并显式声明其路径。

Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南