Flutter运行Android模拟器失败：Gradle任务assembleDebug报错JAVA_HOME未设置

错误信息 #

Launching lib\main.dart on Android SDK built for x86 64 in debug mode...
main.dart:1
ERROR: JAVA_HOME is not set and no 'java' command could be found in your PATH.
Please set the JAVA_HOME variable in your environment to match the
location of your Java installation.
Exception: Gradle task assembleDebug failed with exit code 1
Exited (sigterm)

解决步骤 #

1. 确认Java安装路径 #

找到你的Java安装目录，常见两种情况：

• Android Studio自带JDK：Windows路径一般为C:\Program Files\Android\Android Studio\jbr；Mac路径为/Applications/Android Studio.app/Contents/jbr/Contents/Home
• 单独安装的JDK（Oracle/OpenJDK）：Windows路径类似C:\Program Files\Java\jdk-xx.x.x；Mac路径类似/Library/Java/JavaVirtualMachines/jdk-xx.x.x.jdk/Contents/Home

2. 设置JAVA_HOME环境变量 #

Windows系统

• 右键「此电脑」→「属性」→「高级系统设置」→「环境变量」
• 在「系统变量」区点击「新建」，变量名填JAVA_HOME，变量值填找到的Java安装路径
• 编辑「系统变量」里的Path，添加%JAVA_HOME%\bin
• 保存所有设置，重启VS Code和终端

Mac/Linux系统

• 打开终端，编辑对应shell配置文件（bash用~/.bash_profile，zsh用~/.zshrc），比如执行open -e ~/.zshrc
• 添加以下内容：

  export JAVA_HOME=/你的Java安装路径
  export PATH=$JAVA_HOME/bin:$PATH
  

• 保存文件后执行source ~/.zshrc（对应你的配置文件）使设置生效，重启VS Code

3. 验证设置有效性 #

打开新终端，执行以下命令确认：

echo $JAVA_HOME  # 输出正确的Java安装路径
java -version    # 显示Java版本信息
flutter doctor   # 检查Flutter环境，确认Java相关项无报错

4. 重新运行应用 #

回到VS Code，再次尝试运行Flutter应用，Gradle即可正常执行。

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