Flutter构建失败报错：Release签名配置缺失storeFile属性

核心原因 #

更新Gradle版本后，签名配置中storeFile的路径解析逻辑可能发生变化，导致原本有效的路径无法被正确识别，或是签名文件的引用方式不符合新版本Gradle的要求。

具体修复步骤 #

1. 检查android/app/build.gradle中的签名配置 #

找到signingConfigs代码块，重点确认release配置里的storeFile路径是否正确：

signingConfigs {
    release {
        keyAlias '你的密钥别名'
        keyPassword '你的密钥密码'
        storeFile file('你的签名文件.jks') // 此处路径是检查核心
        storePassword '你的存储密码'
    }
}

• 若签名文件放在android/app目录下，直接写文件名即可；若在其他位置，使用相对路径（如file('../keystores/签名文件.jks')）；
• 确认签名文件确实存在于指定路径，未被误删或移动。

2. 验证Gradle版本兼容性 #

新版本Gradle可能对插件版本有要求，检查android/build.gradle中的Gradle插件版本是否与Gradle wrapper匹配：

buildscript {
    ext.kotlin_version = '1.8.0' // 根据你的项目调整版本
    repositories {
        google()
        mavenCentral()
    }

    dependencies {
        classpath 'com.android.tools.build:gradle:7.4.2' // 确保该版本与Gradle wrapper兼容
        classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:$kotlin_version"
    }
}

3. 清理缓存并重建项目 #

执行以下命令清除旧配置缓存，避免干扰：

flutter clean
flutter pub get
cd android && ./gradlew clean
cd .. && flutter build apk --release

4. 检查系统环境与文件权限 #

更新Java版本后可能影响文件路径解析：

• 确保当前用户对签名文件有读取权限；
• Windows系统避免路径包含中文或特殊字符；
• 可尝试将签名文件复制到android/app目录下，简化路径后重新构建。

5. 确认签名配置关联到Release构建类型 #

检查buildTypes代码块，确保Release类型正确引用了签名配置：

buildTypes {
    release {
        signingConfig signingConfigs.release // 必须存在该行配置
        minifyEnabled true
        shrinkResources true
        proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
    }
}

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