You need to enable JavaScript to run this app. 咨询:运行Flutter应用时Gradle超时报错 无法在安卓模拟器启动
优惠活动
大模型
产品
解决方案
定价
更多

咨询:运行Flutter应用时Gradle超时报错 无法在安卓模拟器启动

问题根因定位
  • 核心崩溃来自Gradle Wrapper的文件锁机制:等待指定版本的gradle-5.6.2-all.zip获取120秒独占访问权限超时。常见触发原因包括:之前的下载进程残留占住文件锁、本地压缩包下载不完整卡滞、跨网拉取官方发行版速度过慢、杀毒软件/系统安全工具扫描文件时占用句柄,导致Gradle拿不到锁权限直接崩溃。
  • flutter doctor报Android Studio插件缺失属于路径识别偏差,并非真的未安装对应插件;无可用设备属于模拟器未完全启动到系统状态,导致的识别失败。
分步解决方案

第一步 清理锁死的本地缓存

  • 先关闭所有正在运行的VS Code、Android Studio、安卓模拟器进程,打开系统任务管理器,结束所有残留的javaw.exe、gradle.exe进程,彻底释放文件句柄。
  • 定位到报错日志里给出的缓存路径:C:\Users\13\.gradle\wrapper\dists\gradle-5.6.2-all\9st6wgf78h16so49nn74lgtbb,删除该路径下所有残留内容,包括没下完的压缩包、隐藏的锁文件。

第二步 解决Gradle下载超时的核心问题

  • 打开项目目录下的Gradle配置文件:android/gradle/wrapper/gradle-wrapper.properties
  • 修改文件里的distributionUrl配置值,把原来指向Gradle官方站点的下载地址,替换成国内开源镜像源上对应gradle-5.6.2-all版本的压缩包路径,大幅降低跨网下载的耗时,从根源上避免长时间等待锁权限的问题。
  • 临时关闭系统杀毒软件、Windows Defender的实时文件扫描功能,避免扫描进程抢占正在下载的压缩包文件,导致Gradle无法获取独占访问权限。

第三步 修复Flutter Doctor的识别异常

  • 启动Android Studio,打开插件管理页面,重新安装一次Flutter、Dart插件,安装完成后重启IDE,触发插件正常加载流程。
  • 在Android Studio的Flutter插件配置页,手动选择本地Flutter SDK的实际安装路径,解决插件无法关联SDK导致的检测误报。
  • 重新启动安卓模拟器,等模拟器完全加载进入系统桌面后,再执行flutter run命令,就能正常识别到连接的设备。

效果验证

所有步骤操作完成后,重新执行flutter run,等待Gradle依赖拉取完成,即可正常启动Flutter应用。

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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.11.08 15:24:03