Flutter可在Android模拟器运行但无法构建APK问题求助

一、手动放置已下载的Gradle文件 #

• 找到Gradle本地缓存目录：
  • Windows：C:\Users\<你的用户名>\.gradle\wrapper\dists\<gradle版本号>\<随机字符串>
  • macOS/Linux：~/.gradle/wrapper/dists/<gradle版本号>/<随机字符串>
• 将手动下载的Gradle压缩包（如gradle-x.x.x-all.zip）直接放入该目录，不要解压
• 若目录内存在.lck锁文件，直接删除，避免Gradle重复发起下载请求

二、配置国内Gradle镜像（替代默认仓库） #

打开项目根目录下的android/build.gradle文件，替换仓库配置为国内镜像源：

buildscript {
    repositories {
        maven { url 'https://maven.aliyun.com/repository/google' }
        maven { url 'https://maven.aliyun.com/repository/jcenter' }
        maven { url 'https://maven.aliyun.com/nexus/content/groups/public' }
    }
    // 保留原有其他配置
}

allprojects {
    repositories {
        maven { url 'https://maven.aliyun.com/repository/google' }
        maven { url 'https://maven.aliyun.com/repository/jcenter' }
        maven { url 'https://maven.aliyun.com/nexus/content/groups/public' }
    }
}

三、清理并重新构建 #

• 执行Flutter项目清理命令：

  flutter clean
  

• 进入android目录执行Gradle清理与构建：

  cd android
  ./gradlew clean build --no-build-cache
  

• 返回项目根目录重新构建APK：

  flutter build apk
  

四、校验Gradle版本一致性 #

打开android/gradle/wrapper/gradle-wrapper.properties，确保distributionUrl的版本与你手动下载的Gradle版本完全一致，例如：

distributionUrl=https\://services.gradle.org/distributions/gradle-7.4-all.zip

若版本不匹配，修改为对应版本号后，重复步骤一的文件放置操作

内容的提问来源于stack exchange，提问作者Roham Zardosht