NextJS的SSR实际运行机制是什么?为何出现console.log与window报错矛盾?
NextJS SSR 执行逻辑说明
- 你的观察不存在矛盾,NextJS的SSR流程默认会让组件代码执行两次:首次访问触发的服务端预渲染阶段、后续的客户端水合/渲染阶段,两个阶段的执行环境完全不同。
- 为什么return中的
console.log看起来只在客户端执行:- 如果你是通过
next/link之类的客户端路由能力跳转进入当前页面,不会触发服务端预渲染逻辑,组件完全在客户端渲染,console.log自然只会输出在浏览器控制台。 - 如果你是首次直连当前页面,组件会先在服务端执行一次(对应log会输出在NextJS启动的终端控制台),再下发到客户端水合执行一次(对应log输出在浏览器控制台),很多人会忽略终端的服务端输出,误以为log只在客户端执行。
- 如果你是通过
- 为什么打印
window会报未定义:
首次直连页面触发服务端预渲染时,服务端是Node.js环境,不存在浏览器专属的window、document等对象,只要你在组件同步执行的顶层逻辑(包括return语句内的同步代码)访问了window,就会在服务端执行阶段直接抛出错误,流程根本走不到客户端执行的步骤,所以会先看到服务端抛出的「window未定义」报错。
规避window访问报错的常用方案:
- 将访问
window的逻辑封装到useEffect回调中,useEffect仅会在客户端执行- 访问
window前添加环境判断:if (typeof window !== 'undefined') { /* 执行逻辑 */ }- NextJS 13+ App Router下,客户端组件添加
'use client'标记,也可配合动态导入设置ssr: false让组件完全跳过服务端渲染
内容的提问来源于stack exchange,提问作者Raul
相关产品推荐
相关产品推荐

