Flutter调试Android模拟器时Gradle无法生成APK的问题求助

核心问题分析 #

你的app/build.gradle存在几个关键问题导致APK生成失败：

• dependencies块内重复执行插件引用，破坏Gradle构建流程
• staging flavor未配置独立的applicationId，可能导致构建产物路径冲突
• 缺少debug buildType配置，Flutter调试依赖debug构建
• compileSdkVersion与targetSdkVersion版本不一致，引发兼容性问题

修复后的app/build.gradle代码 #

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

def flutterRoot = localProperties.getProperty('flutter.sdk')
if (flutterRoot == null) {
    throw new FileNotFoundException("Flutter SDK not found. Define location with flutter.sdk in the local.properties file.")
}

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

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

// 插件引用统一放在文件顶部，不要在dependencies内重复
apply plugin: 'com.android.application'
apply plugin: 'com.google.gms.google-services'
apply plugin: 'com.google.firebase.crashlytics'
apply from: "$flutterRoot/packages/flutter_tools/gradle/flutter.gradle"

def keystoreProperties = new Properties()
def keystorePropertiesFile = rootProject.file('key.properties')
if (keystorePropertiesFile.exists()) {
    keystoreProperties.load(new FileInputStream(keystorePropertiesFile))
}

android {
    compileSdkVersion 33

    defaultConfig {
        applicationId "com.ritemystory.app"
        minSdkVersion 21
        // 统一targetSdkVersion与compileSdkVersion
        targetSdkVersion 33
        versionCode 16
        versionName "1.4.1"
        multiDexEnabled true
    }

    signingConfigs {
        release {
            keyAlias keystoreProperties['keyAlias']
            keyPassword keystoreProperties['keyPassword']
            storeFile keystoreProperties['storeFile'] ? file(keystoreProperties['storeFile']) : null
            storePassword keystoreProperties['storePassword']
        }
        // 添加debug签名配置，使用默认debug密钥
        debug {
            storeFile file('debug.keystore')
            storePassword 'android'
            keyAlias 'androiddebugkey'
            keyPassword 'android'
        }
    }

    buildTypes {
        release {
            minifyEnabled true
            signingConfig signingConfigs.release
        }
        // 添加debug buildType，Flutter调试必须
        debug {
            signingConfig signingConfigs.debug
            minifyEnabled false
        }
    }

    flavorDimensions "default"

    productFlavors {
        dev {
            dimension "default"
            applicationId "com.ritemystory.app.dev"
            versionNameSuffix "-dev"
            resValue "string", "app_name", "RiteMyStory Dev"
        }
        staging {
            dimension "default"
            // 给staging配置独立的applicationId，避免冲突
            applicationId "com.ritemystory.app.staging"
            versionNameSuffix "-staging"
            resValue "string", "app_name", "RiteMyStory Staging"
        }
        prod {
            dimension "default"
            applicationId "com.ritemystory.app"
            resValue "string", "app_name", "RiteMyStory"
        }
    }
}

flutter {
    source '../..'
}

dependencies {
    implementation 'com.android.support:multidex:1.0.3'
}

额外修复步骤 #

• 确保对应flavor的入口文件存在

  • dev: lib/main_dev.dart（你已存在）
  • staging: 创建lib/main_staging.dart
  • prod: 创建lib/main_prod.dart（或直接用lib/main.dart）

• 清理并重新构建
  执行以下命令彻底清理构建缓存：

  flutter clean
  cd android
  ./gradlew clean
  cd ..
  

• 指定flavor运行
  针对dev环境运行：

  flutter run --flavor dev -t lib/main_dev.dart
  

  针对staging环境运行：

  flutter run --flavor staging -t lib/main_staging.dart
  

  针对prod环境运行：

  flutter run --flavor prod -t lib/main.dart
  

• 检查Android SDK版本
  确保本地已安装Android 33的SDK组件（在Android Studio的SDK Manager中查看）

其他排查方向 #

• 确认local.properties中flutter.sdk路径正确
• 检查key.properties文件是否存在且配置正确（仅release构建需要）
• 若仍有问题，执行flutter run -v查看详细构建日志，定位具体错误

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