李弯湾1. 问题现象与背景分析
当你第一次运行Flutter项目时，控制台卡在"Running Gradle task 'assembleDebug'..."这个步骤，进度条长时间不动，甚至可能持续数小时。这种情况通常发生在以下场景：
- 新创建的Flutter项目首次运行
- 切换分支后重新构建
- 清理项目后重新构建
根本原因是Gradle构建系统需要下载特定版本的依赖文件，而默认的下载源（services.gradle.org）在国内访问速度极慢甚至无法连接。Gradle是Android项目的构建工具，Flutter在构建Android平台应用时依赖它。
注意：Gradle的首次运行需要下载wrapper和依赖库，这些文件体积较大（约100MB），网络不畅时极易卡住。
需要模型API调用？ 免费领10W Token，多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 解决方案：配置国内镜像源
2.1 修改gradle-wrapper.properties文件
-
定位文件路径：
code复制/android/gradle/wrapper/gradle-wrapper.properties -
修改distributionUrl：
properties复制distributionUrl=https\://mirrors.cloud.tencent.com/gradle/gradle-7.5-all.zip关键参数说明：
- gradle-7.5-all.zip：必须与Flutter要求的Gradle版本一致
- 腾讯镜像地址：替换了官方的services.gradle.org
-
版本匹配检查：
- 查看flutter doctor建议的Gradle版本
- 或检查/android/build.gradle中的classpath版本
2.2 配置全局Gradle镜像（可选但推荐）
在用户目录下创建或修改gradle.properties：
properties复制systemProp.gradle.wrapperUser=mirrors.cloud.tencent.com
systemProp.gradle.user.home=/path/to/your/gradle/cache