You need to enable JavaScript to run this app. NextJS的SSR实际运行机制是什么?为何出现console.log与window报错矛盾?
优惠活动
大模型
产品
解决方案
定价
更多

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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.21 05:06:02