现象
移动端页面保存草稿时,控制台直接抛出 QuotaExceededError: Failed to execute 'setItem' on 'Storage',整个保存流程中断,用户点保存没有任何提示,刷新后草稿全部丢失。桌面端能成功,手机端复现率高,Safari 无痕模式下一次都存不进去。
原因
localStorage 配额按源计算,Chrome 大约 5MB,Safari 无痕模式只有几 MB,甚至写入直接抛错。它按 UTF-16 存储,一个汉字约占两个单位,图片转 base64 后体积再膨胀三分之一,很快撞上限。配额整站共享,别的模块写多了同样挤占空间。
解决步骤
第一步,捕获异常,别让它冒到业务流程外面。用 try/catch 包住 setItem,判断 err.name 是否等于 QuotaExceededError,命中后走清理和降级逻辑,同时给用户一个明确提示。
function saveDraft(key, data) {
try {
localStorage.setItem(key, data);
return true;
} catch (err) {
if (err.name === "QuotaExceededError") {
clearOldKeys();
return false;
}
throw err;
}
}
第二步,清理不再需要的键。遍历 localStorage 的 key,删掉带 cache_、tmp_ 前缀的过期数据,再重试一次写入;仍然失败就提示用户缓存已满,建议先导出再清空。
第三步,把大对象挪到 IndexedDB。图片、富文本正文这类数据交给 IndexedDB 存 Blob,localStorage 只留索引和版本号,单个键控制在几十 KB 以内,写入失败的概率会明显下降。
验证
在 Application 面板查看已用空间,反复保存直到触发清理逻辑,控制台不应有未捕获异常;再到 Safari 无痕窗口测试,确认会给出提示而不是静默失败。
小结
配额超限本质是整源共享的硬上限,捕获异常、清理旧键、迁移大对象三步做完,页面就不会因为一次写入失败整块崩掉,用户也不会莫名其妙丢掉草稿。
