首次配置Flutter在Android模拟器运行代码时遇到JAVA_HOME配置无效错误

核心报错根因 #

你反复重装Android Studio、Java SDK都没解决问题，核心原因是配置的JAVA_HOME路径存在层级错误：你当前设置的路径为C:\Program Files\Java\jdk-16.0.1\jdk-16.0.1，系统在这个嵌套路径下找不到包含java.exe的有效JDK根目录，才会判定JAVA_HOME无效，进而连锁触发后续Gradle assembleDebug任务执行失败、进程被终止的问题。
这种嵌套路径错误基本是安装/解压JDK时，自动多创建了一层同名版本号文件夹，选择环境变量路径时没有实际校验目录内容，才会反复填错。
另外要说明的是，当前报错发生在Gradle构建阶段，还未到模拟器交互环节，和你使用的Pixel 2模拟器本身没有关系。

分步修复操作 #

• 校验JDK实际有效路径
  打开资源管理器进入C:\Program Files\Java\目录，逐层进入子文件夹，找到直接包含bin、lib、conf等JDK核心目录的根文件夹——判定标准很简单：打开该目录下的bin文件夹，能直接看到java.exe可执行文件，这个目录的完整路径就是你需要的有效JDK路径。
  举个常见的错误场景：你当前设置的嵌套路径C:\Program Files\Java\jdk-16.0.1\jdk-16.0.1下没有任何有效JDK文件，实际的JDK文件是放在上一级的C:\Program Files\Java\jdk-16.0.1目录下，把这个上一级路径找出来就行。
• 修正环境变量配置
  打开系统环境变量设置面板，找到系统变量分类下的JAVA_HOME项，把值改成上面校验过的有效JDK根路径，注意路径末尾不要加多余的反斜杠，也不要嵌套多余的子目录。
  同时检查同面板下的Path系统变量，确保其中存在%JAVA_HOME%\bin的条目，没有的话手动新增，避免全局命令调用识别不到Java运行环境。
• 重启进程让配置生效
  所有环境变量修改完成后，完全关闭所有打开的Android Studio、开发工具、命令行终端窗口，避免旧进程继承之前的无效环境变量。修改完成后打开新的命令行窗口，依次执行以下命令校验配置：
  echo %JAVA_HOME%
java -version
  能正常输出对应JDK的版本信息、没有提示“不是内部或外部命令”，就说明环境变量配置已经全局生效。
• 清理项目缓存重试
  进入Flutter项目根目录，删除android子目录下的.gradle、build文件夹，再回到项目根目录执行flutter clean清理本地构建缓存，完成后重新连接模拟器启动调试。
  如果校验本地独立安装的JDK路径始终有问题，可以直接把JAVA_HOME指向Android Studio安装目录下的jbr文件夹——这个是经过Gradle适配的内置JDK版本，不需要额外安装独立JDK就能满足Flutter的构建要求。

跨分区存储问题说明 #

• Android SDK安装在D盘、Java SDK安装在C盘的跨分区情况，完全不会对本次报错产生任何影响。Windows系统是按照环境变量配置的绝对路径识别并调用程序的，和两个程序所在的磁盘分区没有关联，不存在“不同分区就无法识别调用”的限制。你遇到的问题和跨分区存储没有关系，本质还是JAVA_HOME的路径配置错误。

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