单页应用的路由状态持久化:2400px 归零、5 MB 配额,和 64 MB 的 history.state

举报
yd_263929376 发表于 2026/11/12 16:52:29 2026/11/12
【摘要】 单页应用的路由状态持久化:2400px 归零、5 MB 配额,和 64 MB 的 history.state路由状态该存哪儿,几乎所有单页应用都会撞上同一个岔路口:history.state、sessionStorage、localStorage、URL 查询串,四条路都能走通一半,然后在某个具体场景崩掉。为了不靠印象写这篇,我用 Playwright 1.64.1 驱动本机 Chrome...

单页应用的路由状态持久化:2400px 归零、5 MB 配额,和 64 MB 的 history.state

路由状态该存哪儿,几乎所有单页应用都会撞上同一个岔路口:history.state、sessionStorage、localStorage、URL 查询串,四条路都能走通一半,然后在某个具体场景崩掉。

为了不靠印象写这篇,我用 Playwright 1.64.1 驱动本机 Chrome 157.0.8103.40 搭了一个最小夹具:60 条订单、列表异步 800 ms 渲染、pushState 跳详情、history.back() 回列表,视口 900×700。下面每个数字都是这个夹具跑出来的,每组 3 轮。

一、回退之后,位置从 2400 掉到 0

先把列表滚到 2400px,进详情再退回来:

写法 3 轮最终 scrollY
默认(scrollRestoration = 'auto') 0 / 0 / 0
manual + popstate 里立刻 scrollTo 0 / 0 / 0
manual + 列表渲染完成后 scrollTo 2400 / 2400 / 2400

第二种最容易踩:代码写了恢复逻辑,记录恢复时刻的变量也确实被赋值(说明真的执行到了),位置还是 0。原因在 popstate 触发那一刻的文档高度——日志里是 scrollHeight: 37, maxScroll: 0。scrollTo(0, 2400) 在一个只有 37px 高的文档上会被夹成 0,之后内容渲染到 3600px,浏览器不会替你重试。

二、这不是 SPA 的问题

我原本准备把锅扣在"客户端路由"上,于是做了整页加载的对照组:同样 60 条、同样滚到 2400,用 page.goBack() 触发真实的整页回退。

  • 内容随 HTML 直出:80 ms 时 scrollY 已是 2400,scrollHeight 3660,四次采样(80/400/1200/2200 ms)全是 2400。
  • 内容改成客户端 800 ms 后渲染:80 ms 和 400 ms 采样都是 0,此时 scrollHeight 为 0;1200 ms 时 scrollHeight 涨到 3660,scrollY 依然是 0。

结论很清楚:能不能恢复,取决于浏览器执行恢复那一刻文档有多高,与走不走 SPA 无关。SPA 只是把"内容晚于文档"变成了常态,所以问题暴露得更频繁。整页加载配骨架屏加异步列表,一样归零。

三、恢复的时机是"高度稳定",不是"渲染完成"

知道原因,修法就唯一了:等高度足够再滚。但"渲染完成"这个信号不可靠——图片、字体、虚拟列表的第二批数据都会继续把文档撑高,滚到 2400 之后再被撑高,位置就偏了。

// 等文档高度稳定后再恢复滚动位置;上限 1s,避免骨架屏卡死
async function restoreScroll(target) {
  if (typeof target !== 'number') return;
  const deadline = performance.now() + 1000;
  let last = -1, stable = 0;
  while (performance.now() < deadline) {
    const h = document.documentElement.scrollHeight;
    const max = h - window.innerHeight;
    if (max >= target && h === last) {
      if (++stable >= 2) break;        // 连续两帧高度不变,认为布局已稳
    } else {
      stable = 0;
    }
    last = h;
    await new Promise(r => requestAnimationFrame(r));
  }
  const max = document.documentElement.scrollHeight - window.innerHeight;
  window.scrollTo(0, Math.min(target, max));
}

history.scrollRestoration = 'manual';
addEventListener('popstate', async () => {
  const target = history.state?.scroll;
  await renderRoute(location);         // 路由对应的异步渲染
  await restoreScroll(target);
});

末尾那个 Math.min 不是保险,是必须的:target 可能来自上一次会话,窗口变窄、条目被删都会让高度缩水,不夹一下就会滚到一个不存在的坐标。

四、history.state 的语义:一份快照,不是一块存储

几条容易记错的边界,全部实测:

  • 首屏 history.state 是 null,history.length 是 2。所有"从 state 读初始筛选条件"的代码,都必须有 URL 兜底。
  • 刷新保留。pushState({tab:'orders',page:2,scroll:1840}, '', '/list?tab=orders&page=2') 之后 reload(),state 原样还在——它随会话历史条目一起被序列化。
  • 新标签页访问同一 URL:state 为 null、history.length 为 2。复制链接发给同事,对方拿到的是一个没有 state 的 URL。
  • 改 state 只在内存里生效。history.state.page = 99 读回来是 99,reload() 之后回到 1。序列化发生在 pushState 那一刻,之后改的是副本。
  • 不是所有东西都能放。pushState({fn: () => 1}) 抛 DataCloneError: Failed to execute 'pushState' on 'History': () => 1 could not be cloned.;放 document.body 抛同类错误,消息是 HTMLBodyElement object could not be cloned.。Date 和 Map 能过,读回来还是 [object Date] 和 [object Map]。

体积上有个流传很久的"640 KB 上限",实测不成立:

state 体积 结果 pushState 耗时
1 MB 成功,回读长度一致 8 ms
16 MB 成功 111 ms
32 MB 成功 301 ms
64 MB 成功 593 ms

浏览器不拦,代价是每次导航都要复制一遍,约 7–9 ms/MB,而且这份数据同时活在会话历史里。URL 那侧同样宽松:262,144 字符的查询串 pushState 仍然成功。真正的约束不是 API 限制,是"用户点一次后退要等多久"。

所以 state 里只放路由身份和视图元信息(tab、page、scroll),控制在几百字节;列表数据放内存 store,需要跨刷新时再让 sessionStorage 兜一层。

五、sessionStorage 与 localStorage 的分界

同一夹具测出来的事实:

  • sessionStorage 刷新后仍在(/list?page=2 读得回来),新标签页读不到(null)。这正好匹配"一个标签页一条操作流"的语义。
  • 单 key 上限二分为 5,242,879 字符,即 5 MiB 减 1,再大抛 QuotaExceededError。额度按 UTF-16 码元计:全是中文时同样是 5,242,879 个字符,换成 emoji 只剩 2,621,439 个——一个 emoji 占两格。别指望中文能多存。
  • localStorage 跨 origin 隔离:http://spa.test 写入 route,http://other.test 读回 null。

持久化封装必须包 try/catch,因为配额是全 origin 共享的——别的模块写满了,你的写入就会抛,而抛错的时机通常在用户点"下一页"的时候。

function saveRoute(key, payload) {
  const record = { v: 1, at: Date.now(), data: payload };
  try {
    sessionStorage.setItem(key, JSON.stringify(record));
  } catch (e) {
    if (e.name === 'QuotaExceededError') {
      sessionStorage.removeItem(key);   // 降级:放弃持久化,不影响当前导航
    }
  }
}

v 字段是留给未来的自己:状态结构一改,旧记录就会以"字段缺失"的形式在新代码里炸开,有版本号才能安全丢弃。

六、每点一次筛选,后退键就多一层

夹具里连续 10 次筛选,每次 pushState:history.length 从 2 涨到 12,要按 9 次后退才能回到最初那个查询串为空的列表。

筛选、排序、分页这类同页视图变化,用 replaceState;只有真正换页面才 pushState。判断标准很简单:用户按后退,期望回到上一个页面,还是上一个筛选条件。

顺带一个必须自己记的账:popstate 事件里没有任何方向信息。实测三次前进后退,event.state 依次是 {idx:2}、{idx:1}、{idx:2},与 history.state 完全一致,事件对象上既没有"往前"也没有"往后"。要在 state 里自己维护一个递增的 idx,比较前后值才知道方向,否则"后退关闭弹窗"这类逻辑会在前进时也触发一次。

七、state 和 URL 打架时,错的是 state

最后一个坑是我自己写出来的:pushState({page: 2}, '', '/list?page=3')。当时只是想验证参数顺序,结果 history.state.page 是 2、URLSearchParams 读出来是 3,reload() 之后两者依然不一致。

这不只是笔误。它暴露了一条设计原则:URL 必须是唯一真相,state 只能是它的派生缓存。一旦代码里出现"state 说 2、URL 说 3,该听谁"的判断,就说明有地方在独立维护状态。正确写法是每次导航都由 URL 解析出路由对象,再 replaceState 回填给当前条目:

function syncStateFromUrl() {
  const route = parseRoute(location);                 // 唯一解析入口
  const scroll = history.state?.scroll ?? 0;          // 只有 URL 表达不了的才留在 state
  history.replaceState({ ...route, scroll }, '');
  return route;
}

这样无论用户是点链接进来、刷新、还是从别处粘贴 URL,走到的都是同一份解析结果。

结论

路由状态只有一份可信来源,就是 URL;history.state 是它的附注,sessionStorage 是它的离线副本,三者职责一旦混用,症状总是以"偶发、无法复现"的形式出现。判断标准可以压成一句:这个字段刷新后还能从 URL 推出来吗——能,就别存;不能,才轮到后面两层。

【声明】本内容来自华为云开发者社区博主,不代表华为云及华为云开发者社区的观点和立场。转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息,否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@huaweicloud.com
  • 点赞
  • 收藏
  • 关注作者

评论(0)

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。