为何Play Store版Android应用无法计算派生密钥？

问题根源 #

Release版本启用了代码混淆（minifyEnabled=true）和资源压缩（shrinkResources=true），ProGuard在优化过程中移除了PBKDF2WithHmacSHA256对应的SecretKeyFactory实现类，导致运行时无法找到该算法，密钥派生失败，最终因为空密钥触发IllegalArgumentException崩溃。

解决方案 #

1. 添加ProGuard规则保护加密核心类 #

在proguard-rules.pro中添加以下规则，防止加密相关类被混淆或移除：

# 保留PBKDF2及相关加密类
-keep class javax.crypto.SecretKeyFactory { *; }
-keep class javax.crypto.spec.PBEKeySpec { *; }
-keep class javax.crypto.spec.SecretKeySpec { *; }
# 保留SHA256算法的提供商实现
-keep class com.sun.crypto.provider.* { *; }
-keep class org.bouncycastle.jce.provider.* { *; }

2. 优化Base64编码的兼容性 #

虽然代码标注了@RequiresApi(api = Build.VERSION_CODES.O)，但为了适配更多设备，建议替换为Android系统内置的Base64工具类：

// 替换原Base64编码代码
derivation = android.util.Base64.encodeToString(secret, android.util.Base64.DEFAULT);

3. 增强错误处理逻辑 #

在catch块中补充严谨的错误处理，避免空密钥流入后续流程：

catch (Exception e){
    Log.e("DerivationError", "密钥派生失败: " + e.getMessage());
    // 抛出异常或返回明确错误标识，禁止返回空字符串
    throw new RuntimeException("密钥派生失败", e);
}

4. 本地验证Release包 #

通过gradlew assembleRelease生成Release安装包，在测试设备上验证加密功能正常后，再上传到Play Store。

为什么本地Debug正常？ #

Debug版本默认关闭代码混淆（minifyEnabled=false），所有加密相关类完整保留，因此PBKDF2WithHmacSHA256算法可以正常加载使用。

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