localStorage持久化存在断层，关键在于识别“何时丢、为何丢、丢多少”：iOS易因后台超时、协议隔离、缓存清理丢失数据；Android相对稳定但受targetSdkVersion和混合内容策略影响；需通过切后台检测、冷启动验证、跨域检查快速识别，并采用双写、fallback、服务端协同及IndexedDB降级加固。
移动端 WebView 中 localStorage 的持久化断层，不是“有没有”的问题，而是“什么时候丢、为什么丢、丢多少”的问题。它在 Android 和 iOS 上表现不一，在第三方容器（如 X5、Capacitor）中更难预测。识别断层的关键，是跳出“写入即保存”的惯性认知，转而验证数据是否真能跨进程、跨后台、跨页面生命周期存活。
一、快速识别 localStorage 是否已失效
不依赖肉眼观察或用户反馈，用可复现的轻量级检测逻辑：
-
切后台再切回检测：页面加载时写入
localStorage.setItem('lifespan_test', Date.now())；切至后台 ≥35 秒后切回，立即读取并比对时间差。iOS WKWebView 若返回null或旧值（如相差超 10 秒），说明存储已降级为内存缓存或被清理。 - 冷启动验证：杀掉 App 进程 → 重新打开 → 检查 token、用户偏好等关键键是否存在。Android 多数情况保留，iOS 若未配置持久化 store，大概率为空。
-
跨域隔离验证：若 H5 页面从
https://login.example.com跳转至https://app.example.com，检查后者能否读取前者写入的localStorage。不能读取属正常（同源策略），但若两者域名实际同属example.com却仍隔离，需排查是否因协议（http/https）、端口、子域拼写（如wwwvs 无 www）导致隐式跨域。
二、定位断层发生的典型场景
以下行为在 iOS 上极易触发 localStorage 清空或不可见，在 Android 上相对稳定但非绝对安全：
-
iOS 后台超时释放：WKWebView 实例在后台停留超过约 30 秒，系统可能回收其内存上下文，即使磁盘文件尚存，下次读取也可能失败——尤其当未显式绑定
WKWebsiteDataStore.default()。 - HTTP 页面写入 + HTTPS 页面读取：Android targetSdkVersion ≥ 30 后，混合内容策略会将 HTTP 写入的 localStorage 隔离，HTTPS 页面无法访问；iOS WKWebView 同样存在协议级隔离，且无明确报错提示。
-
第三方容器主动清缓存：如 Cordova 插件启用
clearCacheOnClose，或微信 X5 内核对非白名单域名强制使用 session 级存储，重启即失。 -
低磁盘空间触发系统清理：iOS 将 WKWebView 的 localStorage 存于
Library/Caches/WebKit/，属系统可清理缓存目录；Android 则多存于app_webview/local storage/（非缓存路径），稳定性更高。
三、离线容错的实用加固策略
不追求 100% 持久，而是构建“写入有备份、读取有兜底、丢失可恢复”的三层防线：
-
双写机制（Web + 原生）：登录成功后，H5 端写入
localStorage，同时通过postMessage或 JSBridge 通知原生层，将 token 同步存入 SharedPreferences（Android）或 UserDefaults（iOS）。下次启动时，优先从原生存储恢复，再反写回 localStorage。 -
读取时自动 fallback：页面初始化时，若
localStorage.getItem('token')为空，不直接跳登录页，而是尝试从 URL 参数、cookie（同域且 Path/Domain 正确）、甚至 service worker 缓存中寻找备用凭证。 -
服务端协同校验：前端每次请求携带 token，后端不单验有效性，也检查“最近活跃时间”。若 token 存在但长期未更新（如 >7 天），主动返回
401-refresh，前端触发静默刷新流程，避免用户感知中断。 -
降级使用 IndexedDB（仅必要场景）：对需结构化、批量、高可靠性存储的离线数据（如草稿、表单快照），避免依赖 localStorage，改用 IndexedDB 并配合
caches.open()缓存元数据，提升抗清理能力。
四、平台侧必须做的基础配置
很多断层其实源于 WebView 初始化时的默认行为，几行配置就能规避大部分 iOS 问题：
-
iOS 原生层：创建 WKWebView 时，务必指定持久化数据仓库：
webView.configuration.websiteDataStore = WKWebsiteDataStore.default() -
Android 原生层：确认未调用
WebStorage.getInstance().deleteAllData()或clearCache(true)；targetSdkVersion ≥ 30 时，确保登录页与主站使用一致协议（全 HTTPS）。 -
H5 层统一规范：所有 token 存储键名标准化（如固定用
auth_token），避免大小写、下划线等差异导致重复写入；敏感字段不存明文，至少做简单 base64 或对称混淆（非加密替代）。
