使用MasterKey触发NullPointerException问题求助（Target SDK 31）

针对你遇到的MasterKey初始化时触发的NPE问题，给出以下几个可行的解决方向：

1. 使用MasterKey的默认配置替代手动构建KeyGenParameterSpec #

手动指定KeyGenParameterSpec会导致MasterKey内部调用旧的MasterKeys逻辑去检查密钥存在性，而该逻辑在Android 12（SDK31）的KeyStore2环境下未正确处理服务为空的情况。改用MasterKey内置的简化配置可以规避这个问题：

// 替换原有的spec构建和MasterKey初始化代码
masterKey = MasterKey.Builder(context)
    .setKeyScheme(MasterKey.KeyScheme.AES256_GCM)
    .build()

MasterKey内部会自动生成符合当前系统版本的KeyGenParameterSpec，无需手动配置用途、块模式等参数，同时适配KeyStore2的逻辑。

2. 升级androidx.security.crypto库版本 #

旧版本的security-crypto库在Android 12上存在KeyStore2的兼容性问题，建议将库版本升级到1.1.0或更高稳定版，新版本修复了这类底层服务调用的异常处理逻辑。

3. 添加异常捕获做降级处理 #

如果上述方案仍无法覆盖所有场景，可在初始化代码中添加异常捕获，避免应用崩溃并提供降级方案：

var encryptedSharedPref: SharedPreferences? = null
try {
    masterKey = MasterKey.Builder(context)
        .setKeyScheme(MasterKey.KeyScheme.AES256_GCM)
        .build()
    encryptedSharedPref = EncryptedSharedPreferences.create(
        context,
        context.packageName + ".secure",
        masterKey,
        EncryptedSharedPreferences.PrefKeyEncryptionScheme.AES256_SIV,
        EncryptedSharedPreferences.PrefValueEncryptionScheme.AES256_GCM
    )
} catch (e: NullPointerException) {
    // KeyStore服务不可用时，降级使用普通SharedPreferences
    encryptedSharedPref = context.getSharedPreferences(
        context.packageName + ".secure",
        Context.MODE_PRIVATE
    )
} catch (e: GeneralSecurityException) {
    // 处理加密相关异常
    e.printStackTrace()
}

问题根源 #

Android 12（SDK31）引入了KeyStore2替代旧的KeyStore服务，而你手动构建KeyGenParameterSpec后，MasterKey内部会调用已弃用的MasterKeys类的keyExists方法，该方法未适配KeyStore2的服务初始化逻辑，导致出现IKeystoreService为null的NPE。改用MasterKey的默认配置会跳过旧的MasterKeys逻辑，直接使用适配KeyStore2的代码路径。

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