万无一失依赖可验证、可降级、可追溯的闭环机制,以QuotaExceededError为唯一触发信号,通过分级清理、源头压缩、统一封装和可观测反馈实现存储健壮性。

万无一失不是靠“一次清空”或“预留足够大空间”实现的,而是靠可验证、可降级、可追溯的闭环机制。核心在于:不假设容量够用,不依赖静态估算,只响应真实写入失败信号。
以 QuotaExceededError 为唯一触发点
浏览器不提供“剩余多少字节”的查询接口,localStorage.length 或 JSON.stringify(localStorage) 都无法反映真实占用,甚至可能自身触发异常。唯一可信信号是写入时抛出的 QuotaExceededError。
- 所有 set 操作必须封装在 try-catch 中,捕获该异常后立即进入清理流程
- 清理前先存一个极小测试值(如
test: "1"),避免因单次写入过大误判为满 - 清理完成后重试原操作,而非静默丢弃数据
分级清理,保留最小安全集
盲目调用 localStorage.clear() 会丢失登录态、主题偏好等关键状态,风险极高。应按数据价值和时效性分层处理:
生成可在 deepbi 沙箱 iframe 内运行或作为独立文件运行的交互式 HTML 页面,使用 `window.deepbi` JS SDK 实现数据查询、空间管理、文件浏览及用户操作。当用户提出以下需求时启用该能力: - 创建 KPI 仪表盘、数据表格、文件浏览器、成员列表、管理页面; - 明确要求“转成 dhtml”、“转译成 HTML”、“把 XX 页面转成……”、“控制台页面”、“管理后台”、“DeepBI 页面迁移”; - 提及位于 `apps/console/src/featur
- 优先清除带
expires字段的过期项(如表单草稿、临时 token) - 对长期数据(如用户设置),按
lastUsed时间戳淘汰最久未访问的 N 条 - 强制保留至少 200KB 空间——足够存下 auth_token、错误日志头、基础 UI 状态等救命数据
从源头压缩与分流
清理是兜底,预防才是主线。日常必须控制写入质量:
- 大对象(如图片 base64、完整日志)直接拒绝存 localStorage,改用 sessionStorage 或 IndexedDB
- JSON 数据入库前用
lz-string压缩,实测平均节省 60%–80% 空间 - 用
new TextEncoder().encode(str).length预估 UTF-8 字节数,超阈值(如 50KB)自动拦截并提示 - 所有读写统一走
StorageManager封装类,自动埋点、限流、降级
可观测 + 用户轻量反馈
后台清理不能黑盒运行,需让用户和开发者都感知到状态变化:
- 每 5 分钟调用
navigator.storage.estimate()(Chrome/Edge 支持)估算使用率;不支持时用采样 key+value 长度粗略推算 - 使用率 >80% 时,在设置页右上角显示淡色提示:“本地存储较满,部分缓存可能被自动清理”
- 每次清理动作记录日志(不含敏感内容),上报分析高频耗尽场景(如某类表单草稿占 70% 空间)
- 若清理后仍写入失败,降级至内存缓存,并弹窗提示用户:“请手动清理浏览器本地数据以恢复功能”










