本地存储数据导致安卓应用在三星设备上显示空白Activity问题

故障产生原因 #

• 三星One UI的强制备份逻辑不遵守应用配置：即便你在AndroidManifest.xml中配置了android:allowBackup="false"，部分版本的三星系统仍会在应用更新时，从系统私有的备份分区还原旧版本的SharedPreferences、缓存文件等本地数据，不受应用侧的禁止备份配置约束。
• 新旧版本本地存储结构不兼容：如果新版本对登录状态标识、用户信息等本地存储字段做了修改（比如字段删除、类型变更），三星系统还原的旧版本数据会导致主Activity中的登录状态检测逻辑抛出空指针、类型转换异常，逻辑中断后不会执行后续的页面跳转，最终卡在空白主页面。
• 三星系统进程预加载缓存异常：部分三星设备会在应用更新后预加载旧版本的进程缓存，应用启动时读取到过期内存数据会导致主Activity初始化逻辑异常。

对应解决方案 #

用户侧临时修复 #

除手动清除应用缓存外，也可以直接卸载重装应用，彻底清除三星系统还原的旧版本残留数据。

开发者侧永久修复 #

• 新增本地存储版本兼容逻辑：应用启动时校验本地存储的上次运行版本号，和当前应用版本号对比，检测到版本升级时主动清空存在兼容风险的存储数据，示例逻辑如下：

val sp = getSharedPreferences("app_config", MODE_PRIVATE)
val lastRunVersion = sp.getInt("last_run_version", 0)
val currentVersion = BuildConfig.VERSION_CODE
if (lastRunVersion < currentVersion) {
    // 版本升级，清空存在兼容问题的存储内容
    sp.edit().clear().apply()
    // 若使用DataStore、Room数据库等存储组件，同步执行数据迁移或清空操作
    sp.edit().putInt("last_run_version", currentVersion).apply()
}

• 新增三星专属备份规避配置：在AndroidManifest.xml的application节点补充如下配置，覆盖三星系统的强制备份逻辑：

<application
    android:allowBackup="false"
    tools:replace="android:allowBackup"
    android:fullBackupOnly="false"
    android:fullBackupContent="false">

• 增加逻辑兜底：给主Activity的登录状态检测逻辑添加异常捕获，出现异常时直接清空登录相关本地数据，跳转至登录页，避免卡在空白页面。

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