大对象塞进 localStorage 后首屏发涩:同步存储的主线程代价

把整个 store 快照写进 localStorage,首屏出现明显长任务,输入和滚动都发涩。问题不在数据有多大,而在同步 API 卡在主线程。这篇给出定位方法、四级改造方案和配额溢出的处理。

页面首屏不算慢,但一开始滚动和输入就明显发涩,Performance 面板上赫然一段几百毫秒的 Main 长任务,Call tree 里是 localStorage.setItem 和 JSON.stringify——把整个状态树同步落盘,代价全压在渲染线程上。

localStorage 为什么贵

规范要求这个 API 是同步的:调用发出去,必须等到存储后端返回才能继续。这意味着一次写入的开销包含三部分:

  1. JSON.stringify 在大对象上的序列化成本,完全在主线程;
  2. 跨进程/跨线程到存储后端的往返,同步等待;
  3. 同一 origin 下的写入需要串行化,多标签页场景会互相排队。

第一项和第三项容易被低估。序列化一个几百 KB 的状态树,耗时和对象嵌套深度强相关,不是线性的。多标签页同时写同一个 key 时,后写的那个要等前一个完成,抖动会被放大。

先定位,别猜

打开 Performance 面板录一段首屏,看 Main 轨道上的长任务,展开 Call tree 找 localStorage 或 JSON.stringify 的自身耗时(self time)。线上环境可以用 PerformanceObserver 埋点:

new PerformanceObserver((list) => {
  for (const entry of list.getEntries()) {
    if (entry.duration > 50) {
      // 只上报超阈值的长任务,避免打点量过大
      report('longtask', { duration: Math.round(entry.duration), name: entry.name });
    }
  }
}).observe({ type: 'longtask', buffered: true });

如果长任务的时间点和「用户首次交互」重合,那它就不是加载问题而是交互延迟问题——用户点下去到有反应之间隔着一次同步落盘。

四级改造,按代价从低到高

第一级:只存必要的。 多数应用其实只需要持久化登录态、主题、语言这类小字段,不需要整个 store 快照。先把要存的字段收敛到一个白名单,通常能砍掉一个数量级的体积。

第二级:合并写入并挪到空闲时段。 高频状态变化不必每次都落盘,防抖加 requestIdleCallback,把写入从渲染路径上摘下来:

let pending = null;
let scheduled = false;

const PERSIST_KEYS = ['token', 'theme', 'locale'];

function scheduleSave(state) {
  pending = state;
  if (scheduled) return;
  scheduled = true;

  const run = () => {
    scheduled = false;
    const snapshot = pending;
    pending = null;
    if (!snapshot) return;
    try {
      const payload = {};
      for (const k of PERSIST_KEYS) payload[k] = snapshot[k];
      localStorage.setItem('app-state', JSON.stringify(payload));
    } catch (err) {
      // 配额溢出时不重试,降级为不持久化
      if (err && err.name === 'QuotaExceededError') {
        localStorage.removeItem('app-state');
      }
    }
  };

  if ('requestIdleCallback' in window) {
    requestIdleCallback(run, { timeout: 1000 });
  } else {
    setTimeout(run, 0);
  }
}

timeout 是必须给的:没有它,页面长期繁忙时写入可能永远不执行,用户刷新就丢了状态。

第三级:大对象换 IndexedDB。 真正需要存几百 KB 以上的数据时,IndexedDB 是异步的,读写不阻塞主线程,容量也大得多。代价是 API 啰嗦、首次打开有成本,不要在 render 里 open。

第四级:序列化搬进 Worker。 结构复杂、体积大的快照,可以把 JSON.stringify 放到 Web Worker 里做,主线程只负责 postMessage 和接收结果。注意结构化克隆本身也有成本,传输大对象时要衡量。

读取侧同样会卡

只改写入是不够的。首屏同步读一个大 JSON 再 JSON.parse,同样是一段长任务。常见做法是拆成两级:一个几十字节的「引导键」存版本号和主题这类马上要用的信息,同步读;其余数据异步加载,加载完再合并进 store。

适用边界与常见坑

  • localStorage 的容量在 5MB 量级,各浏览器不完全一致,不要按具体数字做逻辑判断,用 try/catch 兜住 QuotaExceededError。
  • 隐私模式或用户禁用存储时,访问就可能抛异常,所有读写都要包起来,否则整个应用白屏。
  • 不要把 token、手机号这类凭据存进 localStorage,它对同源脚本完全可见。
  • requestIdleCallback 在部分环境下不存在,保留 setTimeout 兜底;Safari 的行为历史上也有差异,别把它当成强保证。
查看「前端与性能」全部文章 →

同分类文章

查看 0 评论 0

评论

正在加载评论…

留言提交后自动审核:正常内容立即显示,含敏感信息的会转人工复核。

大对象塞进 localStorage 后首屏发涩:同步存储的主线程代价 - 起航社区