Android打包报错：无法读取密钥库中密钥fin，:app:packageDebug任务执行失败

错误概述 #

打包时触发以下错误：

从密钥库读取密钥fin失败。
任务':app:packageDebug'执行失败。
执行com.android.build.gradle.tasks.PackageAndroidArtifact$IncrementalSplitterRunnable时发生异常
com.android.ide.common.signing.KeytoolException

签名配置信息：

storePassword=finpro
keyPassword=finpro
keyAlias=fin
storeFile=/Users/macbookpro/Ongoing works/Finpro/fin_pro/keystore/fin-pro.jks

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

排查与解决步骤 #

1. 修正密钥库路径的空格问题 #

路径里的Ongoing works包含空格，Gradle直接解析会出错，可通过两种方式处理：

• 在properties文件中将路径用双引号包裹：storeFile="/Users/macbookpro/Ongoing works/Finpro/fin_pro/keystore/fin-pro.jks"
• 或者用转义字符处理空格：storeFile=/Users/macbookpro/Ongoing\ works/Finpro/fin_pro/keystore/fin-pro.jks
  同时手动确认该路径下fin-pro.jks文件确实存在，无拼写错误。

2. 用keytool验证密钥库有效性 #

执行以下命令直接检查密钥库和别名：

keytool -list -v -keystore /Users/macbookpro/Ongoing\ works/Finpro/fin_pro/keystore/fin-pro.jks -alias fin

依次输入storePassword（finpro）和keyPassword（finpro）：

• 若提示别名不存在：执行keytool -list -v -keystore [密钥库路径]列出所有别名，核对是否存在fin；
• 若提示密码错误：确认密码是否与创建密钥库时一致，注意大小写区分；
• 若文件无法读取：说明密钥库损坏，需重新生成或备份恢复。

3. 检查Debug构建的签名配置关联 #

错误发生在packageDebug任务，但当前仅配置了release签名，需确认：

• 若Debug不需要自定义签名，在buildTypes中移除Debug对该签名的关联：

buildTypes {
    release {
        signingConfig signingConfigs.release
        // 其他配置
    }
    debug {
        signingConfig null // 使用默认调试签名
        // 其他配置
    }
}

• 若Debug需要自定义签名，需在signingConfigs中添加debug节点并填写正确信息。

4. 清理并同步项目 #

• 点击Android Studio的"Sync Project with Gradle Files"按钮，确保配置修改生效；
• 执行Build > Clean Project和Build > Rebuild Project，清除缓存导致的配置异常。

5. 确认密钥库文件权限 #

右键fin-pro.jks文件，选择"显示简介"，在"共享与权限"中确保当前用户拥有"读取与写入"权限。

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