现象
单页应用从列表进详情再点返回,页面总是停在第 200px 附近,不是离开时的位置,偶尔又直接跳到最顶部。代码里明明写了 window.sCrollTo(0, 保存的 y),可每次恢复完又被浏览器拉走,用户要手动往下滑才能接着看。
原因
浏览器默认把 history.scrollRestoration 设为 auto,返回时会自己恢复历史滚动位置,而路由守卫里又手动 scrollTo,两者执行顺序不确定,后执行的一方会覆盖前者。另外列表数据是异步渲染的,恢复时页面高度还没撑开,scrollTo 会被截断在当前最大可滚动值上,表现就是停在半路。
解决步骤
第一步,关掉浏览器的自动恢复。在应用入口最早执行的位置把模式改成 manual,之后滚动位置完全由代码接管,避免和浏览器抢。
history.scrollRestoration = "manual";
const key = "scroll:" + location.pathname;
sessionStorage.setItem(key, String(window.scrollY));
第二步,按页面维度记录离开时的位置。key 里带上路径和查询参数,避免详情页的位置写到列表页上;只存一个数字,不要存整个滚动容器状态,读取时用 Number 兜底。
第三步,等列表渲染完成再恢复。在数据赋值后的 nextTick 里,用 requestAnimationFrame 连续两帧再执行 scrollTo,并判断 document.body.scrollHeight 是否已经大于目标值,不足时推迟重试,最多重试三次。
验证
反复进出同一个列表页十几次,返回位置始终和离开时一致;在慢速网络下把接口延迟调到 2 秒,也不会出现先跳顶部再落回中间的现象,前进后退按钮表现一致。
小结
位置错乱本质是浏览器自动恢复和手动 scrollTo 打架,再加上渲染时序不匹配。关掉自动恢复、按路径存位置、渲染完再滚,三件事都做到位就稳定了。
