You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

Flutter新建项目调试报evaluating settings 'android'构建错误

错误产生原因

该报错本质是Gradle构建时无法读取本地缓存中Flutter工具链的app_plugin_loader.gradle脚本编译产物,由于你没有修改过自动生成的项目代码,问题和业务代码无关,常见诱因有三类:

  • Gradle本地缓存损坏,为最高频原因,多由之前构建异常中断、杀毒软件误隔离缓存文件、磁盘读写错误导致
  • Flutter SDK路径或项目路径存在权限限制、特殊字符/中文,导致Gradle读取脚本时校验失败
  • 蓝叠模拟器ADB连接异常,和Gradle守护进程资源抢占,偶发触发缓存加载失败
排查解决步骤

按优先级从高到低操作即可:

  • 第一步清理损坏的Gradle缓存:先关闭所有代码编辑器、终端窗口,打开任务管理器结束所有带java、gradle、adb标识的进程,直接删除用户目录下的.gradle缓存文件夹,默认路径为C:\Users\你的用户名\.gradle。回到项目根目录依次执行flutter clean、flutter pub get后重新构建,八成以上的场景这步就能修复。
  • 第二步校验路径合法性:确认Flutter SDK存放路径、项目存放路径全程为纯英文,没有中文、空格、特殊符号,不要放在云同步文件夹、加密磁盘、系统权限受控的目录下。如果路径不符合要求,移动到非系统盘的纯英文根目录(比如C:\dev\flutter)后重新配置Flutter环境变量,到项目的android目录下执行gradlew.bat --stop停掉所有残留的Gradle守护进程,再重新构建。
  • 第三步校验Flutter环境完整性:终端执行flutter doctor -v,如果检测到组件缺失或损坏,执行flutter precache重新拉取全量构建依赖;如果仍有异常,切换到Flutter稳定渠道、重新安装稳定版SDK即可。
  • 第四步排查模拟器连接问题:打开蓝叠模拟器的设置,确认已开启ADB调试,执行flutter devices确认设备被正常识别,调试时不要同时连接其他安卓设备、开启其他模拟器,避免ADB端口冲突。
  • 第五步解决依赖拉取异常:如果存在网络问题导致Gradle依赖拉取不全,可给项目配置国内可用的Gradle镜像源,修改android/build.gradle下的仓库配置,将公共镜像源放在google()、mavenCentral()前面,再重新拉取依赖构建。

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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.08.30 10:48:19