咨询:运行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
相关产品推荐
相关产品推荐

