执行flutter build appbundle命令出现:app:signReleaseBundle任务失败报错

报错原因 #

Execution failed for task ':app:signReleaseBundle'报错本质是Release包签名配置校验失败，可按照以下步骤逐一排查： #

1. 校验密钥文件路径配置 #

• Windows系统下路径转义容易出错，建议将storeFile的双反斜杠写法C:\\Users\\asus\\Desktop\\key.jks替换为正斜杠写法C:/Users/asus/Desktop/key.jks
• 更稳妥的方案是把key.jks文件移动到项目android/app目录下，storeFile直接填写key.jks即可，避免跨设备路径不兼容问题
• 确认key.jks文件未被移动、删除或重命名，路径完全匹配填写内容

2. 校验android/app/build.gradle配置 #

首先确认文件头部已经正确导入key.properties配置：

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

其次确认签名配置正确引用参数：

android {
    // 其他配置省略
    signingConfigs {
        release {
            keyAlias keystoreProperties['keyAlias']
            keyPassword keystoreProperties['keyPassword']
            storeFile keystoreProperties['storeFile'] ? file(keystoreProperties['storeFile']) : null
            storePassword keystoreProperties['storePassword']
        }
    }
    buildTypes {
        release {
            signingConfig signingConfigs.release
            // 其他配置省略
        }
    }
}

3. 校验密钥信息正确性 #

• 确认创建jks时设置的storePassword、keyPassword、keyAlias和key.properties中填写的内容完全一致，注意大小写、首尾空格等隐形字符
• 可通过命令行验证密钥信息：运行keytool -list -v -keystore 你的jks文件完整路径，输入存储密码后核对输出的别名是否和填写的keyAlias匹配

4. 清理缓存重新打包 #

依次执行以下命令后重试打包：

flutter clean
flutter pub get
flutter build appbundle

5. 处理密钥格式过时警告 #

如果遇到JKS格式过时的警告，可执行命令转换为PKCS12格式：

keytool -importkeystore -srckeystore 旧jks文件路径 -destkeystore 新jks文件路径 -deststoretype pkcs12

转换完成后更新key.properties中的storeFile路径即可。 #

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