Visual Studio Code运行Flutter报错javaHome路径无效如何解决

问题背景 #

此前使用Flutter时配置的JDK路径为D:/jdk，重新分区后JDK重装至C:\Program Files\Java\jdk-16.0.1，在VS Code中运行应用时出现构建失败，错误提示如下：

Supplied javaHome must be a valid directory. You supplied: D:\jdk
已尝试重装Gradle、JDK、VS Code均无法解决。

已验证有效解决方案 #

• 关闭所有VS Code窗口
• 清空Windows系统临时文件：按下Win+R打开运行窗口，输入%temp%回车，全选目录内所有文件，删除所有可删除的内容
• 清理VS Code全局缓存：进入路径C:\Users\你的系统用户名\AppData\Roaming\Code，删除该目录下的Cache、CachedData两个文件夹
• 重启电脑后重新打开VS Code运行项目即可

可选辅助检查步骤 #

如果执行上述操作后仍未解决，可逐一排查以下配置：

• 检查Flutter全局配置：终端运行flutter config，查看返回的java-home配置是否为新的JDK路径，若仍为旧路径可执行flutter config --java-home "C:\Program Files\Java\jdk-16.0.1"手动更新
• 检查项目级Gradle配置：打开项目根目录下的android/gradle.properties文件，确认是否存在硬编码的org.gradle.java.home配置项，若存在则将值修改为新的JDK路径
• 检查VS Code配置：按下Ctrl+,打开设置面板，搜索java.home，确认用户设置、工作区设置中均没有留存旧的D盘JDK路径

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