Android密码安全存储：SharedPreferences与AES加密实践

1. SharedPreferences基础与密码存储场景分析在Android应用开发中用户登录状态的持久化是一个基础但至关重要的功能。SharedPreferences作为Android平台提供的轻量级存储方案特别适合保存用户偏好设置和小规模数据比如记住密码功能。与SQLite数据库相比它不需要复杂的表结构设计与文件存储相比它提供了更简单的键值对操作接口。核心优势对比读写效率SharedPreferences采用XML文件存储在内存中维护缓存读取时无需磁盘IO线程安全内部通过同步锁机制保证多线程访问安全使用简便无需处理文件路径和流操作API封装完善在密码存储场景中我们需要特别注意安全性问题。虽然SharedPreferences文件默认存储在应用私有目录/data/data/包名/shared_prefs/但root后的设备仍可能被窃取数据。因此绝对不能直接存储明文密码必须结合加密算法处理。2. 安全存储方案设计与实现2.1 加密方案选型对于密码等敏感信息推荐采用AES对称加密结合Base64编码的方案private const val AES_ALGORITHM AES private const val AES_TRANSFORMATION AES/CBC/PKCS5Padding private const val CHARSET UTF-8 fun encrypt(data: String, secretKey: String): String { val cipher Cipher.getInstance(AES_TRANSFORMATION) val keySpec SecretKeySpec(secretKey.toByteArray(CHARSET), AES_ALGORITHM) cipher.init(Cipher.ENCRYPT_MODE, keySpec) val encrypted cipher.doFinal(data.toByteArray(CHARSET)) return Base64.encodeToString(encrypted, Base64.DEFAULT) }警告切勿将加密密钥硬编码在代码中建议通过密钥派生函数如PBKDF2动态生成。2.2 SharedPreferences工具类封装创建安全的SharedPreferences操作工具类object SecurePrefs { private const val PREFS_NAME user_credentials private const val KEY_USERNAME encrypted_username private const val KEY_PASSWORD encrypted_password private val sharedPrefs: SharedPreferences by lazy { App.context.getSharedPreferences(PREFS_NAME, Context.MODE_PRIVATE) } fun saveCredentials(username: String, password: String) { val editor sharedPrefs.edit() editor.putString(KEY_USERNAME, encrypt(username)) editor.putString(KEY_PASSWORD, encrypt(password)) editor.apply() } fun getCredentials(): PairString?, String? { val username sharedPrefs.getString(KEY_USERNAME, null)?.let { decrypt(it) } val password sharedPrefs.getString(KEY_PASSWORD, null)?.let { decrypt(it) } return username to password } fun clearCredentials() { sharedPrefs.edit().clear().apply() } }3. 完整登录流程实现3.1 登录界面数据绑定在LoginActivity中实现UI逻辑class LoginActivity : AppCompatActivity() { private lateinit var binding: ActivityLoginBinding override fun onCreate(savedInstanceState: Bundle?) { super.onCreate(savedInstanceState) binding ActivityLoginBinding.inflate(layoutInflater) setContentView(binding.root) // 自动填充保存的凭证 val (username, password) SecurePrefs.getCredentials() username?.let { binding.etUsername.setText(it) } password?.let { binding.etPassword.setText(it) } binding.btnLogin.setOnClickListener { performLogin( binding.etUsername.text.toString(), binding.etPassword.text.toString(), binding.cbRemember.isChecked ) } } private fun performLogin(username: String, password: String, remember: Boolean) { if (remember) { SecurePrefs.saveCredentials(username, password) } else { SecurePrefs.clearCredentials() } // 执行登录网络请求... } }3.2 多设备同步处理当应用需要支持账号多端登录时建议采用服务端存储加密后的凭证客户端生成设备唯一ID将加密凭证与设备ID绑定上传服务端其他设备登录时从服务端获取该用户的所有设备凭证使用本地密钥解密后使用interface AuthService { POST(credentials/save) suspend fun saveCredentials( Body request: CredentialRequest ): ApiResponseUnit GET(credentials/list) suspend fun getCredentials(): ApiResponseListCredentialDto } data class CredentialRequest( val deviceId: String, val encryptedUsername: String, val encryptedPassword: String )4. 高级优化与安全加固4.1 密钥安全管理方案方案对比表方案优点缺点适用场景硬编码实现简单极易被反编译获取完全不推荐NDK存储增加逆向难度仍需保护so文件中低安全要求服务端下发动态更新密钥依赖网络高安全要求TEE环境硬件级保护设备兼容性问题金融级应用推荐实现object KeyManager { init { System.loadLibrary(secure-keys) } external fun getAesKey(): String external fun getIvParameter(): String }对应的C实现在jni目录中#include jni.h #include string extern C JNIEXPORT jstring JNICALL Java_com_example_KeyManager_getAesKey(JNIEnv* env, jobject) { std::string key dynamic_key_from_ndk; // 实际应从复杂算法生成 return env-NewStringUTF(key.c_str()); }4.2 生物识别集成对于高安全要求的应用可以增加生物识别验证后才填充密码private fun showBiometricPrompt() { val promptInfo BiometricPrompt.PromptInfo.Builder() .setTitle(身份验证) .setSubtitle(使用生物特征解锁凭证) .setAllowedAuthenticators(BIOMETRIC_STRONG or DEVICE_CREDENTIAL) .build() val biometricPrompt BiometricPrompt( this, ContextCompat.getMainExecutor(this), object : BiometricPrompt.AuthenticationCallback() { override fun onAuthenticationSucceeded(result: BiometricPrompt.AuthenticationResult) { autoFillCredentials() } }) biometricPrompt.authenticate(promptInfo) }5. 问题排查与性能优化5.1 常见问题解决方案问题1跨进程访问异常现象MODE_MULTI_PROCESS已废弃多进程应用出现数据不同步解决方案方案A使用ContentProvider封装SharedPreferences访问方案B迁移到支持多进程的DataStore问题2加密数据损坏现象解密时抛出IllegalBlockSizeException排查步骤检查Base64编码是否正确验证加密/解密使用相同的IV参数确保密钥未被意外修改5.2 性能优化建议延迟加载不要过早初始化SharedPreferences应在首次使用时加载批量操作多次编辑时使用apply()而非commit()数据清理定期清理过期的凭证数据大小监控单个pref文件不宜超过1MB过大时应考虑分片fun monitorPrefsSize() { val file File(${context.filesDir.parent}/shared_prefs/$PREFS_NAME.xml) if (file.length() MAX_PREFS_SIZE) { cleanOldEntries() } }6. 现代化替代方案虽然SharedPreferences仍被广泛使用但Google推荐的新方案是Preferences DataStore迁移对比表特性SharedPreferencesDataStore异步API需自行封装原生支持线程安全部分完全类型安全弱强错误处理无完善数据一致性一般强基础迁移示例val Context.loginDataStore: DataStorePreferences by preferencesDataStore( name login_prefs, produceMigrations { context - listOf(SharedPreferencesMigration(context, old_prefs_name)) } ) val USERNAME_KEY stringPreferencesKey(encrypted_username) val PASSWORD_KEY stringPreferencesKey(encrypted_password) suspend fun saveWithDataStore(username: String, password: String) { context.loginDataStore.edit { prefs - prefs[USERNAME_KEY] encrypt(username) prefs[PASSWORD_KEY] encrypt(password) } }在实际项目中如果已经大量使用SharedPreferences可以采用渐进式迁移策略新功能使用DataStore实现旧功能逐步迁移。对于记住密码这种简单场景如果已经稳定运行且无多进程需求SharedPreferences仍然是合理的选择。