Android MasterKeyBuilder自定义别名异常及密钥稳定性咨询

一、无自定义别名的MasterKey稳定性问题 #

不用担心里默认别名的MasterKey在系统更新后失效。官方文档明确说明：

• 默认MasterKey存储在Android Keystore中，密钥是设备绑定且持久化存储的，除非用户手动清除应用数据、恢复出厂设置，否则不会丢失或变更。
• 系统更新只会修复Keystore的安全漏洞，不会修改已生成的应用密钥，之前加密的文件依然可以正常解密。

二、自定义别名抛出异常的原因与修复 #

你遇到的InvalidProtocolBufferException异常，本质是自定义别名的MasterKey参数不匹配导致的：

• 默认别名的MasterKey会自动预设密钥用途（加密+解密），但使用自定义别名时，需要显式指定密钥用途，否则密钥的元数据格式不符合EncryptedFile的要求。
• 如果之前用错误参数创建过同名的"myAlias"密钥，Keystore中留存的旧密钥元数据会导致解析失败。

修复后的代码示例： #

// 先清理可能存在的错误密钥（可选，第一次创建可跳过）
if (MasterKey.exists(context, "myAlias")) {
    MasterKey.deleteIfExists(context, "myAlias");
}

// 显式指定密钥用途，确保参数一致
MasterKey masterKey = new MasterKey.Builder(context, "myAlias")
        .setKeyScheme(MasterKey.KeyScheme.AES256_GCM)
        .setPurpose(MasterKey.PURPOSE_ENCRYPT | MasterKey.PURPOSE_DECRYPT)
        .build();

EncryptedFile encryptedFile = new EncryptedFile.Builder(
        context,
        privateKeyFile,
        masterKey,
        EncryptedFile.FileEncryptionScheme.AES256_GCM_HKDF_4KB
).build();

三、官方文档核心要点总结 #

1. MasterKey持久化规则：所有通过MasterKey生成的密钥都存储在Android Keystore，与应用生命周期绑定，不受系统更新影响，仅在应用数据被清除时才会丢失。
2. 自定义别名的约束：每次创建同一别名的MasterKey时，必须保证setKeyScheme、setPurpose、setKeySize等参数完全一致，否则会因为密钥元数据不匹配抛出解析异常。
3. 默认别名的优势：默认别名的MasterKey已经预设了符合EncryptedFile要求的参数，无需额外配置即可稳定运行，安全性和自定义别名无差异。

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