新建Flutter项目无法运行（Java版本错误）

问题场景 #

创建新Flutter应用时触发构建错误，提示Android Gradle插件需要Java 17，但当前使用的是Android Studio自带的Java 11。已通过Brew安装OpenJDK 17并配置了JAVA_HOME，终端验证版本正确，但问题依旧。

解决方案 #

1. 配置Android Studio使用指定JDK #

打开Android Studio，依次进入：

• Settings（Mac为Preferences） → Build, Execution, Deployment → Build Tools → Gradle
• 在Gradle JDK下拉菜单中，选择通过Brew安装的OpenJDK 17，路径为/opt/homebrew/opt/openjdk@17/
• 应用设置后重启Android Studio

2. 直接在项目中指定Gradle使用的JDK #

打开Flutter项目根目录下的gradle.properties文件，添加以下配置：

org.gradle.java.home=/opt/homebrew/opt/openjdk@17/

该配置会强制Gradle使用指定JDK，不受系统环境变量或IDE默认配置影响。

3. 确保终端环境变量生效 #

• 在终端执行命令重新加载zsh配置：

  source ~/.zshrc
  

• 验证JAVA_HOME和Java版本：

  echo $JAVA_HOME
  java -version
  

  确认输出版本为Java 17。若使用Android Studio内置终端，需重启Android Studio让新环境变量生效。

4. 清理项目缓存后重新构建 #

执行以下命令清理并重建项目：

flutter clean
flutter run

或在Android Studio中点击Build → Clean Project，完成后再点击Rebuild Project。

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