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

Flutter项目执行assembleRelease构建任务失败如何解决?

问题原因
  • Gradle构建过程中无法拉取到指定的Android构建工具依赖,涉及com.android.tools.build:builder:4.1.0和com.android.tools.build:bundletool:0.14.0两个构件
  • 国内用户绝大多数情况是网络限制导致无法正常访问谷歌官方maven源
  • 少部分情况为本地Gradle缓存损坏、Android Gradle Plugin(AGP)与Gradle版本不匹配导致的依赖解析异常
解决方法

方案一:替换为国内镜像源(优先尝试)

修改Android目录下的两个配置文件:

  1. 打开android/build.gradle,替换buildscript和allprojects下的repositories配置:
buildscript {
    ext.kotlin_version = '1.7.10' // 保持你自己项目的kotlin版本即可
    repositories {
        maven { url 'https://maven.aliyun.com/repository/google' }
        maven { url 'https://maven.aliyun.com/repository/jcenter' }
        maven { url 'https://maven.aliyun.com/repository/public' }
        google()
        mavenCentral()
    }
    dependencies {
        // 保持你原有配置的AGP版本不变即可,这里是4.1.0
        classpath "com.android.tools.build:gradle:4.1.0"
        classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:$kotlin_version"
    }
}

allprojects {
    repositories {
        maven { url 'https://maven.aliyun.com/repository/google' }
        maven { url 'https://maven.aliyun.com/repository/jcenter' }
        maven { url 'https://maven.aliyun.com/repository/public' }
        google()
        mavenCentral()
    }
}
  1. 打开android/gradle/wrapper/gradle-wrapper.properties,替换gradle下载地址为国内镜像:
# AGP 4.1.0对应适配Gradle 6.5~6.7.1版本,不要修改为不兼容的版本
distributionUrl=https\://mirrors.cloud.tencent.com/gradle/gradle-6.7-all.zip

方案二:清理缓存重试

如果已经配置过镜像仍然报错,执行以下操作:

  • 项目根目录执行flutter clean清理项目本地缓存
  • 删除当前用户根目录下的.gradle/caches文件夹,清除全局Gradle缓存
  • 重新执行构建命令即可

方案三:核对版本匹配

确认你项目的AGP版本和Gradle版本适配:AGP 4.1.0必须搭配6.5-6.7.1区间的Gradle版本,版本不兼容会直接导致依赖解析失败。

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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.09.26 01:45:03