Gradle构建失败：无法生成.apk文件的问题求助

报错信息：

Gradle build failed to produce an .apk file. It's likely that this file was generated under <app_root>, but the tool couldn't find it

已尝试操作：

• 修改Gradle distributionURL
• 调整Kotlin版本
• 更新com.android.tools.build:gradle版本
• 添加输出文件路径

排查与解决步骤 #

1. 手动确认APK生成状态 #

先检查APK是否实际生成，默认路径：

• Debug版本：<项目根目录>/build/app/outputs/apk/debug/app-debug.apk
• Release版本：<项目根目录>/build/app/outputs/apk/release/app-release.apk
  如果文件存在，说明是Flutter工具的路径识别问题，可直接使用该APK；如果不存在，需查看完整构建日志定位失败原因。

2. 获取完整Gradle构建日志 #

运行带日志参数的构建命令，提取详细报错：

flutter build apk --verbose

日志会暴露具体问题（如依赖冲突、语法错误、签名配置异常等），是核心排查依据。

3. 修复语法错误（核心问题） #

app/build.gradle中存在Lambda表达式语法错误：

// 错误写法
localPropertiesFile.withReader("UTF-8") { reader -
    localProperties.load(reader)
}

修改为正确的箭头语法：

// 正确写法
localPropertiesFile.withReader("UTF-8") { reader ->
    localProperties.load(reader)
}

该语法错误会直接中断Gradle解析，是导致构建失败的关键原因。

4. 统一Gradle插件版本 #

当前配置中AGP版本不一致：

• android/build.gradle使用com.android.tools.build:gradle:8.1.4
• settings.gradle中com.android.application版本为8.1.0
  将settings.gradle中的版本统一为8.1.4：

id "com.android.application" version "8.1.4" apply false

5. 规范BuildTypes配置 #

Release版本使用Debug签名配置可保留，但建议明确配置避免歧义：

buildTypes {
    release {
        signingConfig signingConfigs.debug
        minifyEnabled false
        proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
    }
    debug {
        signingConfig signingConfigs.debug
    }
}

6. 清理缓存后重新构建 #

执行清理命令消除缓存影响：

flutter clean
flutter pub get
flutter build apk

用户提供的配置文件 #

gradle-wrapper.properties #

distributionBase=GRADLE_USER_HOME
distributionPath=wrapper/dists
zipStoreBase=GRADLE_USER_HOME
zipStorePath=wrapper/dists
distributionUrl=https\://services.gradle.org/distributions/gradle-8.4-all.zip

android\build.gradle #

buildscript {
    ext.kotlin_version = '1.9.10' // Version de Kotlin
    repositories {
        google()
        mavenCentral()
    }
    dependencies {
        classpath 'com.android.tools.build:gradle:8.1.4' // Version compatible avec Kotlin 1.9.10
        classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:$kotlin_version"
    }
}

allprojects {
    repositories {
        google()
        mavenCentral()
    }
}

tasks.register("clean", Delete) {
    delete rootProject.buildDir
}

app\build.gradle #

plugins {
    id "com.android.application"
    id "kotlin-android"
    id "dev.flutter.flutter-gradle-plugin"
}

def localProperties = new Properties()
def localPropertiesFile = rootProject.file("local.properties")
if (localPropertiesFile.exists()) {
    localPropertiesFile.withReader("UTF-8") { reader -
        localProperties.load(reader)
    }
}

def flutterVersionCode = localProperties.getProperty("flutter.versionCode")
if (flutterVersionCode == null) {
    flutterVersionCode = "1"
}

def flutterVersionName = localProperties.getProperty("flutter.versionName")
if (flutterVersionName == null) {
    flutterVersionName = "1.0"
}

android {
    namespace = "com.example.vertbaudet_webview"
    compileSdk = 34 // Mettez à jour cette valeur si nécessaire
    ndkVersion = flutter.ndkVersion

    compileOptions {
        sourceCompatibility = JavaVersion.VERSION_17
        targetCompatibility = JavaVersion.VERSION_17
    }

    defaultConfig {
        applicationId = "com.example.vertbaudet_webview"
        minSdk = 21 // Mettez à jour cette valeur si nécessaire
        targetSdk = 33 // Mettez à jour cette valeur si nécessaire
        versionCode = flutterVersionCode.toInteger()
        versionName = flutterVersionName
    }

    buildTypes {
        release {
            signingConfig = signingConfigs.debug
        }
    }
}

dependencies {
    implementation "org.jetbrains.kotlin:kotlin-stdlib:$kotlin_version"
    implementation 'androidx.core:core-ktx:1.13.1'
    implementation 'androidx.lifecycle:lifecycle-runtime-ktx:2.8.0'
    implementation 'androidx.lifecycle:lifecycle-livedata-ktx:2.8.0'
    implementation 'androidx.lifecycle:lifecycle-viewmodel-ktx:2.8.0'
    // Ajoutez ou mettez à jour d'autres dépendances nécessaires
}

flutter {
    source = "../.."
}

settings.gradle #

pluginManagement {
    def flutterSdkPath = {
        def properties = new Properties()
        file("local.properties").withInputStream { properties.load(it) }
        def flutterSdkPath = properties.getProperty("flutter.sdk")
        assert flutterSdkPath != null, "flutter.sdk not set in local.properties"
        return flutterSdkPath
    }()

    includeBuild("$flutterSdkPath/packages/flutter_tools/gradle")

    repositories {
        google()
        mavenCentral()
        gradlePluginPortal()
    }
}

plugins {
    id "dev.flutter.flutter-plugin-loader" version "1.0.0"
    id "com.android.application" version "8.1.0" apply false
    id "org.jetbrains.kotlin.android" version "1.9.10" apply false
    id("org.gradle.toolchains.foojay-resolver-convention") version("0.5.0")
}

include ":app"

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