Flutter构建release签名包报keystore password was incorrect错误

问题描述 #

构建Flutter应用签名发布包（release bundle）时抛出如下错误：

Execution failed for task ':app:signReleaseBundle'.
> A failure occurred while executing com.android.build.gradle.internal.tasks.FinalizeBundleTask$BundleToolRunnable
   > Failed to read key key0 from store "/Users/username/keystores": keystore password was incorrect

执行签名检查命令./gradlew signingReport返回相同错误：

Variant: release
Config: release
Store: /Users/myname/keystores
Alias: key0
Error: Failed to read key key0 from store "/Users/myname/keystores": keystore password was incorrect

首次出现该问题时清理Android项目可修复，当前清理项目无效。
相关配置如下：

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 GradleException("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'
}

apply plugin: 'com.android.application'
apply plugin: 'kotlin-android'
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 31

    compileOptions {
        sourceCompatibility JavaVersion.VERSION_1_8
        targetCompatibility JavaVersion.VERSION_1_8
    }

    kotlinOptions {
        jvmTarget = '1.8'
    }

    sourceSets {
        main.java.srcDirs += 'src/main/kotlin'
    }

    defaultConfig {
        applicationId "myApplicationId"
        minSdkVersion 24
        targetSdkVersion 31
        versionCode flutterVersionCode.toInteger()
        versionName flutterVersionName
        multiDexEnabled true
    }

    signingConfigs {
        release {
            keyAlias keystoreProperties['keyAlias']
            keyPassword keystoreProperties['keyPassword']
            storeFile keystoreProperties['storeFile'] ? file(keystoreProperties['storeFile']) : null
            storePassword keystoreProperties['storePassword']
        }
    }

    buildTypes {
        release {
            signingConfig signingConfigs.release
            shrinkResources false
            minifyEnabled false
        }
    }
}

flutter {
    source '../..'
}

dependencies {
    implementation "org.jetbrains.kotlin:kotlin-stdlib-jdk7:$kotlin_version"
}

local.properties #

sdk.dir=/Users/myName/Library/Android/sdk
flutter.sdk=/users/myName/developer/flutter
flutter.buildMode=release
flutter.versionName=0.1.5
flutter.versionCode=6

已尝试的排查操作：

• 清理并重新构建项目
• 尝试默认密码（"changeit"、"android"、"password"、空密码）
• 删除build文件夹
• 重新安装Flutter、Dart与Android Studio

根因分析与解决步骤 #

从报错信息里的keystore路径/Users/myname/keystores可以先定位第一个高概率问题：当前配置的storeFile指向的是文件夹，不是具体的签名文件，Gradle无法从目录读取签名信息，会抛出密码错误类的异常，这也是之前清理缓存能临时修复、现在失效的核心原因。按以下优先级逐一排查：

1. 修正签名文件路径配置
   打开项目根目录下的key.properties文件，检查storeFile配置项，必须指向具体的签名文件（后缀通常为.jks/.keystore/.p12），不能指向存放签名文件的文件夹。例如正确配置应为：

   storeFile=/Users/myname/keystores/release_sign.jks
   

   修改完成后先执行./gradlew signingReport验证，若能正常输出签名MD5、SHA1等信息，说明路径配置正确。
2. 排查key.properties配置值的隐藏字符问题
   若路径修正后仍报错，检查配置项是否存在不可见字符：
   • 四个配置项（keyAlias/keyPassword/storeFile/storePassword）的等号两侧不要加空格，不要在值末尾加多余换行、空格
   • 不要从文档、聊天软件复制配置值，手动逐字输入密码和别名，避免带入全角字符、零宽空格等不可见内容
   • 确保key.properties为UTF-8无BOM编码，用纯文本编辑器（VS Code、系统自带记事本）编辑，不要用Word等带格式的编辑器修改
3. 验证签名文件本身有效性
   用JDK自带的keytool工具直接验证签名文件和密码是否匹配，执行命令：

   keytool -list -v -keystore 你的签名文件完整路径
   

   执行后手动输入记录的密码，若能正常输出证书别名、有效期、指纹信息，说明签名文件和密码本身无问题；若此处也报密码错误，说明密码记录有误或签名文件已损坏。
4. 排查JDK版本兼容性问题
   若签名文件本身验证正常但Gradle仍报错，检查JDK版本一致性：
   • 执行./gradlew --version查看当前Gradle构建使用的JDK版本
   • 执行keytool --version查看生成签名文件时使用的JDK版本
     若两个版本跨度超过2个大版本（比如用Java 17生成签名、Gradle用Java 8构建），将Android Studio的Gradle JDK切换为和生成签名一致的版本，再重新构建。
5. 极端情况处理
   若以上操作都无法解决，且确认签名文件已损坏/密码遗忘，直接生成新的签名文件重新配置即可，注意新签名文件要多备份几份，后续应用上架更新必须使用同一个签名，否则无法正常覆盖安装。

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