You need to enable JavaScript to run this app. Android Studio Arctic Fox升级后Flutter项目运行出现Gradle错误如何解决
优惠活动
大模型
产品
解决方案
定价
更多

Android Studio Arctic Fox升级后Flutter项目运行出现Gradle错误如何解决

修复Android Studio Arctic Fox升级后Flutter项目Gradle报错方案

1. 解决内置JDK识别异常问题

Android Studio Arctic Fox版本调整了内置JDK的目录结构,将原有jre目录替换为jbr,导致Flutter默认路径读取失败,对应不同系统操作如下:

  • Mac系统
    打开终端依次执行命令:
    cd /Applications/Android\ Studio.app/Contents/jre
    ln -s ../jbr jdk
    ln -s "/Applications/Android Studio.app/Contents/jbr/Contents/Home" /Library/Java/JavaVirtualMachines/jdk-11.0.10.jdk
    
    执行完成后重启终端,运行flutter doctor确认Java相关报错消失。
  • Windows系统
    进入Android Studio安装根目录,找到jbr文件夹,复制全部内容到同层级的jre文件夹(如果不存在jre文件夹则手动新建)。
    新增系统环境变量JAVA_HOME,值设置为AS安装路径下的jbr目录,例如C:\Program Files\Android\Android Studio\jbr,再将%JAVA_HOME%\bin添加到系统Path变量中。
  • Linux系统
    打开终端依次执行命令:
    cd 你的Android Studio安装目录/android-studio/jre
    ln -s ../jbr jdk
    
    把export JAVA_HOME=你的Android Studio安装目录/android-studio/jbr添加到~/.bashrc或~/.zshrc配置文件末尾,执行source ~/.bashrc(对应你使用的shell类型)让配置生效。

以上操作完成后重启Android Studio,原本Project Structure中无法设置Java SDK的问题会自动修复,可正常识别到内置JDK。

2. 匹配Gradle与JDK版本

Arctic Fox内置JDK版本为11,旧版本Gradle无法兼容JDK 11,需要调整项目Gradle配置:

  • 打开项目android/gradle/wrapper/gradle-wrapper.properties文件,修改distributionUrl参数,将Gradle版本升级到7.0及以上,示例:
    distributionUrl=https\://services.gradle.org/distributions/gradle-7.0.2-all.zip
    
  • 打开项目android/build.gradle文件,升级Android Gradle插件版本到7.0及以上,示例:
    dependencies {
        classpath 'com.android.tools.build:gradle:7.0.4'
    }
    

3. 清除缓存重启构建

所有配置修改完成后依次执行:

  • 终端运行flutter clean清除项目缓存
  • 完全关闭Android Studio后重新打开项目
  • 执行flutter run尝试启动项目

内容的提问来源于stack exchange,提问作者Nuwan Thisara

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.09 23:36:01