Flutter构建失败：Java.exe未找到解决办法

Flutter 开发中遇到“java.exe not found”构建失败错误令人头疼，但其实质并非环境变量未设，而是新版 Android Studio 已移除完整 JRE，导致 Gradle 无法找到合法的 JDK；本文直击要害，手把手教你通过安装兼容的 OpenJDK 17、精准配置 JAVA_HOME 与 Gradle 的 org.gradle.java.home、严格清理缓存四步法，彻底解决该问题——操作简洁、验证充分、覆盖 VS Code 和 Android Studio 双场景，助你秒速回归高效构建。

本文详解 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 Files\Android\Android Studio\jre\bin\java.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:\dev\jdk-17.0.1

2. 正确配置 JAVA_HOME 环境变量

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

3. 告知 Flutter/Gradle 使用该 JDK

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

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:\dev\jdk-17.0.1；
• 避免混用多个 JDK 版本——Flutter、Gradle、Android Studio 应统一使用同一 JDK 17 实例。

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

理论要掌握，实操不能落！以上关于《Flutter构建失败：Java.exe未找到解决办法》的详细介绍，大家都掌握了吧！如果想要继续提升自己的能力，那么就来关注golang学习网公众号吧！