Android应用API缓存存储、自动登录及登出清缓存实现方案咨询

嘿，这个需求在Android开发里太常见了，我给你拆解成几个核心步骤，从存储方案到自动登录再到登出清除，一步步来：

你要存的是API返回的登录凭证（比如token、用户ID这类），绝对不要存明文密码！推荐用Jetpack DataStore（官方现在更推荐这个，异步且安全），如果是老项目用SharedPreferences也能搞定。这里重点说DataStore，顺带提SharedPreferences的写法。

1. 登录成功后存储凭证 #

先创建DataStore实例（可以封装成工具类或者放在ViewModel里）：

// 在Context的扩展里定义DataStore
private val Context.dataStore: DataStore<Preferences> by preferencesDataStore(name = "login_prefs")

// 定义存储的键
private val TOKEN_KEY = stringPreferencesKey("auth_token")
private val USER_ID_KEY = stringPreferencesKey("user_id")

// 存储方法，用协程异步执行
suspend fun saveLoginInfo(token: String, userId: String) {
    dataStore.edit { preferences ->
        preferences[TOKEN_KEY] = token
        preferences[USER_ID_KEY] = userId
    }
}

登录API返回成功后，调用这个方法存储凭证：

// 比如在ViewModel的登录方法里
viewModelScope.launch {
    val loginResult = apiService.login(username, password)
    if (loginResult.isSuccess) {
        saveLoginInfo(loginResult.token, loginResult.userId)
        // 跳转到主页面
        _navigateToMain.value = true
    } else {
        // 登录失败提示
        _loginError.value = loginResult.message
    }
}

2. 应用启动时自动登录 #

在启动页（SplashActivity）或者MainActivity的初始化阶段，读取存储的凭证，验证后自动登录：

// 在启动页的onCreate里
viewModelScope.launch {
    val prefs = dataStore.data.first()
    val token = prefs[TOKEN_KEY]
    val userId = prefs[USER_ID_KEY]

    if (!token.isNullOrEmpty() && !userId.isNullOrEmpty()) {
        // 先调用API验证token是否有效（避免token过期）
        val isTokenValid = apiService.checkTokenValidity(token)
        if (isTokenValid) {
            // 自动登录成功，跳主页面
            startActivity(Intent(this@SplashActivity, MainActivity::class.java))
        } else {
            // token过期，清除缓存并跳登录页
            clearLoginInfo()
            startActivity(Intent(this@SplashActivity, LoginActivity::class.java))
        }
    } else {
        // 无缓存凭证，直接跳登录页
        startActivity(Intent(this@SplashActivity, LoginActivity::class.java))
    }
    finish()
}

如果用SharedPreferences，写法更简单：

// 存储
val sharedPref = getSharedPreferences("login_prefs", Context.MODE_PRIVATE)
with(sharedPref.edit()) {
    putString("auth_token", token)
    putString("user_id", userId)
    apply() // 异步提交，别用commit()（同步阻塞）
}

// 读取
val token = sharedPref.getString("auth_token", null)
val userId = sharedPref.getString("user_id", null)
// 后续验证逻辑和上面一致

不管用DataStore还是SharedPreferences，清除逻辑都很直接：

DataStore清除： #

suspend fun clearLoginInfo() {
    dataStore.edit { prefs ->
        // 可以删除指定键，或者直接清空所有
        prefs.remove(TOKEN_KEY)
        prefs.remove(USER_ID_KEY)
        // prefs.clear() // 清空整个缓存文件
    }
}

点击登出按钮时调用：

logoutBtn.setOnClickListener {
    viewModelScope.launch {
        // 先调用API的登出接口（如果后端需要）
        apiService.logout(currentToken)
        // 清除本地缓存
        clearLoginInfo()
        // 跳登录页并关闭当前页面
        startActivity(Intent(this@MainActivity, LoginActivity::class.java))
        finish()
    }
}

SharedPreferences清除： #

val sharedPref = getSharedPreferences("login_prefs", Context.MODE_PRIVATE)
sharedPref.edit().clear().apply()

• 敏感信息加密：如果你的应用涉及敏感数据，一定要用加密存储！比如用EncryptedSharedPreferences或者Encrypted DataStore，防止root设备读取明文缓存。举个EncryptedSharedPreferences的例子：

val masterKeyAlias = MasterKeys.getOrCreate(MasterKeys.AES256_GCM_SPEC)
val encryptedPref = EncryptedSharedPreferences.create(
    "encrypted_login_prefs",
    masterKeyAlias,
    applicationContext,
    EncryptedSharedPreferences.PrefKeyEncryptionScheme.AES256_SIV,
    EncryptedSharedPreferences.PrefValueEncryptionScheme.AES256_GCM
)
// 后续存储读取和普通SharedPreferences一样

• token过期全局处理：除了启动时验证，还要在网络请求的拦截器里处理401错误（token过期），此时自动清除缓存并跳登录页，避免用户在操作中突然报错。
• 异步操作规范：DataStore必须在协程或Flow里操作，别在主线程阻塞；SharedPreferences用apply()而不是commit()，避免阻塞主线程。

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