Flutter Windows 下“Running Gradle task ‘assembleDebug‘...” 卡住一整天的终极解决办法

XI锐真的烦2025-11-22 23:16

Flutter Windows 下"Running Gradle task 'assembleDebug'..." 卡住一整天的终极解决办法（2025最新亲测有效）

最近好多小伙伴（包括我自己）在 Windows 上跑 Flutter 项目的时候，都遇到一个超级恶心的假死问题：

明明代码没改，flutter run 一下就卡在这一行，转半天小菊花：

复制代码

Running Gradle task 'assembleDebug'...

等半天不动，日志里还疯狂打印它在下载一个叫 NDK (Side by side) 27.0.12077973 的东西，1GB+，速度还只有几 KB/s！

我踩了一整天坑，终于找到了最稳定、最一劳永逸的解决方案，分享给大家，5 分钟搞定！

问题根本原因

Flutter 3.19+ + Android Studio Iguana/Hedgehog + Gradle 8.x 之后，默认会强制拉取最新的 NDK 27.x 版本，而且这个版本巨大 + Google 服务器在国内巨慢，基本等于卡死。

最推荐的解决方案（99%的人用这个就行）

步骤1：用 Android Studio 安装一个稳定小巧的 NDK 版本

打开 Android Studio → More Actions → SDK Manager
切换到 SDK Tools 标签页
勾选以下两个（必须都勾！）：
- NDK (Side by side) → 推荐勾 25.1.8937393（体积最小，最兼容！）
- CMake（顺手装上）
点击 Apply 安装，400～600MB，几分钟就下完了

步骤2：项目里强制使用你刚装的 NDK 版本（也可以省略）

打开项目下的 android/app/build.gradle 文件，在 android {} 块里加上这一行：

gradle 复制代码

android {
    compileSdk 35

    // 这一行必须加！锁死 NDK 版本，彻底杜绝自动下载 27.x
    ndkVersion "25.1.8937393"

    defaultConfig {
        applicationId "com.example.yourapp"
        minSdkVersion 21
        targetSdkVersion 35
        versionCode flutterVersionCode.toInteger()
        versionName flutterVersionName
    }

    // 其他配置...
}

步骤3：清理并重新运行

bash 复制代码

flutter clean
flutter pub get
flutter run

基本 10～30 秒就出结果了！再也不会卡那个破进度条了！

终极防坑模板（以后新建项目直接复制这几行）

gradle 复制代码

android {
    compileSdk 35
    ndkVersion "25.1.8937393"   // 锁版本，永不翻车！

    defaultConfig {
        minSdkVersion 21
        targetSdkVersion 35
    }
}

额外小 tip

如果你项目根本没用到 C++ 原生代码（大多数纯 Flutter 项目都没用），还可以直接把 externalNativeBuild 那整段注释掉，更干净。
想用 26.x 也行，换成 "26.1.10909125" 就行，但 25.1 是目前最稳最小的。

亲测 2025 年 11 月最新版 Flutter 3.24+ + Android Studio Koala 依然完美有效！