SSR 水合失败整页重渲染 闪白 600 ms 时间戳怎么对齐

SSR 页面出来后总是闪一下,白屏大概 200ms,然后内容重新出现。PerformanCe 里水合之后跟着一个 600ms 的长任务,控制台报 Hydration failed,初始 UI 和服务端对不上。

第一反应是两边的 HTML 结构不一致,逐个组件对,div 层级和 class 都能对上。真正对不上的是文本:服务端渲染的是「3 分钟前」,客户端算出来「4 分钟前」,差值就在两次渲染之间。

试过 suppressHydrationWarning,警告没了,React 还是把整棵子树丢掉重渲染,闪白照旧。这个属性只压警告,不解决问题。

换成把时间相关的部分挪到挂载后渲染。服务端输出占位符,客户端 useEffect 里再算。随机 ID 换成 useId,服务端和客户端各生成一次但能对上。

const [now, setNow] = useState(null);
useEffect(() => setNow(Date.now()), []);
return <time>{now ? fmt(now) : "--"}</time>;

这段有个副作用:首屏那行字从「3 分钟前」变成「--」,视觉上跳一下。用固定宽度的占位撑住,别又引入新的 CLS。

评论列表也有同样的问题,但它本来就在首屏之外,服务端不渲染,直接客户端拉。省掉这块 SSR 之后,TTFB 从 480ms 降到 320ms,水合的长任务也从 600ms 掉到 120ms。

还有个更隐蔽的:服务端用了 Intl 格式化,客户端时区不同,同一个时间戳出来差 8 小时。开发机都是东八区,测不出来,海外用户一进来就水合失败。

修法是把时区固定成东八区再格式化,或者只传 ISO 字符串,客户端按本地时区显示。业务要的是「几分钟前」,那就统一在客户端算。

复测时用 4 倍 CPU 降速跑,水合长任务从 600ms 到 480ms,剩下的时间在解析首屏那段 JSON。这块单独排期,不在这次范围内。

确认方式:打开 React DevTools 的高亮更新,水合后整页闪一次就说明整树重渲染了。正常的页面只有交互的局部在闪。

现在 SSR 只覆盖首屏商品信息,时间、随机数、登录态一律延迟到客户端。两次渲染算出来的东西必须完全一样,这条比任何性能数字都重要。

您可以还会对下面的文章感兴趣: