跳到正文

我所理解的 Nuxt 最佳实践(2):按请求隔离状态,让客户端接得住首屏

我所理解的 Nuxt 最佳实践

  1. 沿着路由组织页面和自动导入
  2. 按请求隔离状态,让客户端接得住首屏(当前)
  3. 用插件依赖声明启动顺序
  4. 部署前检查资源与服务端产物

在个人主页直接刷新,Header 上的登录按钮和菜单出现了错位。同一个页面从站内点过去却正常。客户端导航按当时的状态渲染,直接刷新还需要让浏览器用第一次渲染接管服务端已经输出的 HTML。排查时,我先分开记录服务端输出按钮时读到的值,以及客户端接管时读到的值。

让 Header 在自己的渲染阶段拿到初始输入

一次问题来自页面插槽的回写。Header 已经按原状态输出 HTML,随后页面才把新值写进共享状态。客户端接管时读到了新值,首帧预期就可能和已经输出的 HTML 不一致。把 Header 的按钮和弹窗交回 Header,根据路由、用户数据和配置读取初始状态,页面就可以专心管理主体的请求、刷新和错误。

服务端 Header 先按旧值输出 HTML,页面随后回写,浏览器接管时读到新值

另一次没有页面回写。SSR 和浏览器首帧拿到了不同的登录态。即使状态归属已经理顺,服务端输出的分支仍可能和客户端预期不同。能在服务端确定的初始状态,应让客户端从同一份初始数据开始。只能在浏览器判断的内容,可以用稳定占位表达等待,或用 <ClientOnly> 延后渲染,同时考虑首屏留白和占位样式。完整案例保留了 key、v-show 和 <ClientOnly> 各自能解决的范围。见《一次 Nuxt SSR hydration 错位复盘》。

先区分请求数据和浏览器资源

当前账号、权限和页面数据需要随应用或请求隔离。把可变的用户数据放进服务端模块顶层,会让它的生命周期比单次请求更长。使用 Nuxt useState 或 Pinia 时,要从当前应用上下文获取状态,并明确哪些数据要进入客户端 payload。页面取数、缓存和写后刷新怎样分工,见《React、Vue 与 Nuxt 的数据工具选型》。

吸顶 Header 用到的滚动容器、ResizeObserver 和动画帧都属于浏览器。服务端可以返回业务认可的空操作,等客户端第一次使用时再创建共享实例。DOM 由提供节点的组件注册和释放。重置共享实例时,一起停止监听、observer 和动画帧,再清掉旧引用。这里还要检查被导入的模块是否会在顶层访问浏览器对象,因为进入函数后的客户端分支管不到模块初始化。见《给 Nuxt 模块级 composable 补上静态护栏》。

分开验证隔离和接管

检查请求隔离时,用两次不同用户的服务端请求确认数据各自独立。检查 hydration 时,记录同一请求对应的服务端 HTML、客户端首帧输入和最终 DOM。浏览器专属状态另外验证卸载和重进页面后的行为,例如重新进入个人主页时是否还在监听上一份滚动容器。静态规则可以指出可疑的模块级状态,最后能否正确接管仍要从渲染和交互结果判断。