Android指纹认证报错java.security.InvalidKeyException问题求助

这个错误的核心原因是你生成密钥时的配置与后续Cipher使用的加密参数不匹配——具体来说，你在初始化Cipher时指定了PKCS7填充，但生成密钥时没有声明该密钥支持这种填充模式，导致AndroidKeyStore拒绝了密钥操作。

问题定位 #

看你的validateFingerPrint方法中，生成密钥的代码只设置了算法和块模式：

keyGenerator.init(KeyGenParameterSpec.Builder(keyName ,KeyProperties.PURPOSE_ENCRYPT or KeyProperties.PURPOSE_DECRYPT)
    .setBlockModes(KeyProperties.BLOCK_MODE_CBC)
    .setUserAuthenticationRequired(false)
    .build())

但在initCipher里，你使用的Cipher参数包含了PKCS7填充：

val cipherAlgorithm = "${KeyProperties.KEY_ALGORITHM_AES}/${KeyProperties.BLOCK_MODE_CBC}/${KeyProperties.ENCRYPTION_PADDING_PKCS7}"

AndroidKeyStore要求密钥生成时必须明确声明它支持的所有加密参数（块模式、填充等），否则密钥无法与对应的Cipher配合使用。

修复方案 #

在KeyGenParameterSpec.Builder中添加填充模式的声明，确保和Cipher使用的填充一致：

keyGenerator.init(KeyGenParameterSpec.Builder(keyName ,KeyProperties.PURPOSE_ENCRYPT or KeyProperties.PURPOSE_DECRYPT)
    .setBlockModes(KeyProperties.BLOCK_MODE_CBC)
    .setEncryptionPaddings(KeyProperties.ENCRYPTION_PADDING_PKCS7) // 新增这一行
    .setUserAuthenticationRequired(true) // 建议改成true，符合指纹认证的安全要求
    .build())

额外提示 #

• 如果你是为了指纹认证场景，setUserAuthenticationRequired(true)是更合理的配置：它会限制密钥只能在用户通过生物识别（指纹/面部）或设备锁屏验证后才能使用，提升安全性。
• 确保所有Cipher的参数（算法、块模式、填充）和密钥生成时的配置完全一致，这类密钥不兼容的错误大多源于参数不匹配。

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