03.7.1.2 SSR 原理与 Hydration
所属:全栈开发面试题库 / 03 前端基础与 Web 开发 / 03.7 SSR、SSG 与全栈前端 / 03.7.1 SSR 与全栈前端
03.7.1.2-001 服务端渲染的完整流程是什么?
一句话结论
请求到达服务端后,匹配路由与组件、初始化状态、拉取数据,把组件渲染为 HTML 字符串并注入注水数据;浏览器收到后先展示 HTML,再加载 JS 完成 hydration 接管交互。
概念解释
- 服务端阶段:路由匹配、取数、渲染字符串。
- 传输阶段:HTML 与注水数据一并下发。
- 客户端阶段:展示 HTML、hydration 接管。
原理流程
- 服务端接收请求,解析 URL 与请求头。
- 匹配路由组件,创建独立应用实例与状态容器。
- 执行数据获取,填充状态。
- 渲染组件为 HTML 字符串,序列化状态注入页面。
- 浏览器解析 HTML,加载 JS 后 hydration。
代码 / 示例
服务端:
请求 → 路由匹配 → 初始化 store → 取数
→ 渲染 HTML → 注入注水数据 → 响应
客户端:
展示 HTML → 加载 JS → 恢复状态 → hydration
常见误区
- 误区:服务端只把模板拼字符串;正解:同构 SSR 执行组件逻辑、状态与数据获取,不只是模板替换。
- 误区:服务端渲染后客户端不再初始化;正解:客户端需用注水数据重新初始化组件树。
追问
- Q:服务端取数在哪个阶段做? A:在渲染组件之前或组件加载时完成,具体钩子与机制按框架确认。
- Q:HTML 字符串如何生成? A:框架提供服务端渲染 API 输出标记流或字符串,具体 API 按框架版本确认。
03.7.1.2-002 同构代码在服务端执行有哪些限制?
一句话结论
服务端运行环境没有 window、document、DOM 事件与浏览器存储,组件不能在渲染期直接访问浏览器 API;平台相关逻辑需环境判断、延迟到客户端生命周期或由服务端 mock 兜底。
概念解释
- 缺失对象:DOM、BOM、浏览器存储、屏幕与导航对象。
- 无事件循环差异:服务端为 Node/边缘运行时,无浏览器渲染线程。
- 隔离需求:平台代码不能在服务端渲染路径执行。
原理流程
- 识别组件中访问浏览器对象的位置。
- 用环境判断包裹,或延迟到挂载后执行。
- 服务端路径提供 mock 或跳过浏览器专属逻辑。
代码 / 示例
服务端安全写法:
if (typeof window !== 'undefined') {
// 访问 window/document 的逻辑
}
浏览器专属初始化放到客户端挂载钩子中
常见误区
- 误区:服务端能调用浏览器存储;正解:
localStorage/sessionStorage/cookie读取需在服务端从请求头解析,不能访问客户端存储 API。 - 误区:组件里直接
document.querySelector在 SSR 也能跑;正解:渲染期无 DOM,访问会抛错,需改为客户端挂载后操作。
追问
- Q:服务端如何读取 Cookie? A:从请求头
Cookie解析,注入服务端状态,客户端再同步。 - Q:第三方库在服务端报错怎么办? A:检查库是否访问浏览器 API,用动态导入或客户端延迟加载,兼容性按库文档确认。
03.7.1.2-003 数据注水(脱水/复水)是如何工作的?
一句话结论
服务端把已取数的状态序列化为嵌入 HTML 的字符串(脱水),客户端读取该字符串反序列化恢复状态(复水),避免 hydration 后重复请求相同数据并保证两端初始状态一致。
概念解释
- 脱水:服务端状态 → 可传输字符串。
- 复水:字符串 → 客户端状态。
- 一致性:两端以同一份初始状态渲染。
原理流程
- 服务端取数后状态就绪。
- 状态序列化写入 HTML 的脚本标签或数据位。
- 客户端初始化时读取并反序列化。
- 组件以注水状态 hydration,不重复请求。
代码 / 示例
<script id="__INITIAL_STATE__" type="application/json">
{"user":{"id":1}}
</script>
常见误区
- 误区:注水数据可以传函数或类实例;正解:序列化只支持可结构化传输的数据,函数与循环引用需转换。
- 误区:注水后客户端还要重新拉一遍;正解:已注水数据作为初始状态复用,后续刷新再走请求。
追问
- Q:注水数据有安全风险吗? A:嵌入 HTML 的内容需注意 XSS,序列化应转义特殊字符,避免脚本注入。
- Q:注水数据过大有什么影响? A:增大 HTML 体积与客户端解析耗时,非首屏数据应按需加载。
03.7.1.2-004 hydration 在浏览器端的完整流程是什么?
一句话结论
浏览器解析已有 HTML 后加载框架 JS,读取注水数据初始化状态,遍历组件树与已有 DOM 匹配挂载,绑定事件并恢复组件生命周期;完成后页面从静态 HTML 转为可交互应用。
概念解释
- 匹配:组件与已有 DOM 节点对应。
- 绑定:注册事件监听与状态订阅。
- 就绪:组件树挂载完成,可响应用户操作。
原理流程
- HTML 解析与首屏展示。
- JS 下载执行,框架读取注水数据。
- 初始化组件实例与状态。
- 遍历 DOM 匹配节点、挂载事件。
- 标记 hydration 完成,进入可交互。
代码 / 示例
hydration 步骤:
加载 JS → 复水状态 → 创建组件实例
→ 匹配 DOM → 绑定事件 → 可交互
常见误区
- 误区:hydration 把 HTML 全部丢弃重建;正解:复用已有 DOM,仅在匹配失败时重渲染。
- 误区:hydration 在 HTML 展示前完成;正解:浏览器先展示 HTML,JS 加载执行后才接管。
追问
- Q:hydration 阶段可以修改 DOM 吗? A:组件应让框架管理 DOM,直接操作已有节点容易造成匹配混乱。
- Q:如何判断 hydration 已完成? A:框架提供 hydration 完成回调或状态标识,具体 API 按版本确认。
03.7.1.2-005 hydration mismatch 是怎么产生的?
一句话结论
服务端与客户端首次渲染结果不一致时产生 mismatch:两侧渲染的文本、属性、结构或顺序不同,常见原因包括随机值、时间、浏览器 API、未注水数据与环境差异。
概念解释
- 不一致:服务端 HTML 与客户端初次渲染输出对不上。
- 触发因素:非纯渲染、环境取值、数据缺失。
- 结果:警告、重渲染或交互异常。
原理流程
- 服务端按当时数据与环境渲染 HTML。
- 客户端首次渲染使用不同数据或取值。
- 比对 DOM 节点/属性/文本发现差异。
- 框架报 mismatch 警告并按策略重渲染。
代码 / 示例
典型差异来源:
Math.random()、Date.now() 两端不同
服务端未注水导致客户端用默认值
浏览器对象在两端取值不同
常见误区
- 误区:mismatch 只是控制台警告可忽略;正解:不一致可能导致 DOM 重挂、事件丢失或内容闪烁。
- 误区:时间显示不一致无所谓;正解:渲染期使用当前时间会让两端必然不一致,应注水或延迟到客户端渲染。
追问
- Q:如何避免随机数导致 mismatch? A:渲染期不使用随机值,随机项在客户端挂载后生成。
- Q:两端数据为什么会不同? A:服务端取数结果未注水,客户端初始化拿默认值,需保证注水数据完整。
03.7.1.2-006 mismatch 如何排查与定位?
一句话结论
按警告指出的组件与属性/文本位置定位,对比服务端 HTML 与客户端初次渲染输出,核对取值来源、数据注水与环境判断;从外层到内层逐步缩小差异节点。
概念解释
- 警告定位:框架给出差异节点与属性。
- 对比输出:查看服务端 HTML 与客户端首渲染。
- 溯源:差异值来自哪个数据源或 API。
原理流程
- 读取 mismatch 警告中的组件与节点信息。
- 保存服务端返回的 HTML 片段。
- 在客户端复现初次渲染输出并对比。
- 核对取值、注水状态与环境分支。
代码 / 示例
排查步骤:
警告节点 → 查看服务端 HTML
→ 客户端初次渲染对比
→ 核对时间/随机/API/注水数据
常见误区
- 误区:只看报错所在的叶子节点;正解:差异可能来自外层数据或条件分支,需向上溯源。
- 误区:关闭警告即可解决;正解:消除警告需让两端渲染结果一致。
追问
- Q:如何对比两端输出? A:查看服务端响应 HTML 与客户端 hydration 前的初次渲染,具体调试方式按框架确认。
- Q:第三方组件导致 mismatch 怎么办? A:确认组件是否服务端安全,必要时客户端延迟加载该组件。
03.7.1.2-007 服务端为什么要为每个请求隔离上下文?
一句话结论
服务端为每个请求创建独立的应用实例、状态容器与路由上下文,避免上一用户的状态、缓存或单例对象泄漏到下一请求;共享单例在并发下会造成数据串号与污染。
概念解释
- 单例风险:模块级状态被多请求复用。
- 独立实例:每请求新建 store/应用实例。
- 上下文传递:请求级数据在本次渲染链路内流转。
原理流程
- 请求进入时创建新的应用与状态实例。
- 本次请求数据注入独立上下文。
- 渲染完成后实例随请求销毁。
- 下一请求重新创建,不复用旧状态。
代码 / 示例
隔离原则:
模块级变量不存用户状态
每请求 new 独立 store/实例
请求结束释放引用,避免内存残留
常见误区
- 误区:服务端 store 可以全局复用提速;正解:跨请求复用会把用户数据串给其他请求,属于安全与正确性问题。
- 误区:全局常量也需要每请求重建;正解:只读配置可共享,可变用户状态必须隔离。
追问
- Q:服务端内存泄漏如何产生? A:请求实例、定时器或订阅未释放,长期累积占用内存。
- Q:依赖单例的库如何在 SSR 中使用? A:检查库是否支持请求级实例,必要时按请求重新初始化。
03.7.1.2-008 SSR 中样式如何处理?
一句话结论
服务端渲染时需收集组件用到的样式并注入到返回 HTML(内联或提取 CSS 文件),保证首屏 HTML 带样式展示;样式方案需支持服务端收集,避免客户端 hydration 后才加载样式造成闪烁。
概念解释
- 样式收集:服务端遍历组件提取规则。
- 注入位置:HTML
<head>内联或链接样式表。 - 闪烁避免:首屏关键样式随 HTML 到达。
原理流程
- 服务端渲染组件时收集样式规则。
- 样式内联进 HTML 或生成 CSS 产物引用。
- 浏览器解析 HTML 时样式已就绪。
- 客户端 hydration 后样式接管一致。
代码 / 示例
样式链路:
服务端收集组件样式 → 注入 head
→ 首屏带样式展示
→ 客户端样式表接管
常见误区
- 误区:CSS-in-JS 在服务端自动可用;正解:需使用支持服务端收集的方案并提取样式,具体 API 按库确认。
- 误区:首屏样式等客户端 JS 加载后再生成;正解:那样会出现无样式闪烁(FOUC),关键样式应随 HTML 下发。
追问
- Q:服务端样式与客户端样式如何避免重复? A:首屏内联关键样式,其余走样式表,具体策略按构建链确认。
- Q:全局样式污染如何控制? A:按模块隔离样式方案,避免服务端收集到的规则跨页面残留。
03.7.1.2-009 浏览器 API 在服务端如何兜底处理?
一句话结论
对必须在浏览器使用的 API,服务端路径做环境判断跳过、提供最小 mock 或改为客户端动态导入;不能在服务端渲染期调用真实浏览器对象,避免抛错中断渲染。
概念解释
- 环境判断:按
typeof window区分执行路径。 - 延迟执行:放到客户端挂载后钩子。
- mock 兜底:服务端提供空实现避免空引用。
原理流程
- 梳理浏览器 API 调用点。
- 服务端路径跳过或 mock。
- 客户端路径在挂载后执行真实调用。
代码 / 示例
兜底方式:
环境判断包裹
客户端挂载后初始化
专属组件动态导入(客户端侧)
常见误区
- 误区:给服务端挂一个全局
windowmock 就能跑所有库;正解:mock 行为与浏览器不一致,可能产生错误渲染结果。 - 误区:把浏览器专属代码放到模块顶层即可;正解:顶层代码在服务端导入时就执行,仍会触发浏览器 API 访问。
追问
- Q:浏览器专属组件怎么在 SSR 中加载? A:使用客户端侧动态导入或条件渲染,具体机制按框架确认。
- Q:服务端能读取 URL/地域信息吗? A:从请求头与请求参数获取,不依赖浏览器
window.location。
03.7.1.2-010 SSR 服务端如何匹配路由?
一句话结论
服务端根据请求 URL 在路由表中匹配组件与参数,把匹配结果注入渲染上下文;路由规则需与客户端一致,保证首次直出与后续导航指向相同页面。
概念解释
- URL 解析:路径、参数、查询串。
- 路由表:路径模式到组件的映射。
- 一致性:两端路由规则与参数解析对齐。
原理流程
- 服务端读取请求路径与查询。
- 遍历路由表匹配模式与参数。
- 命中组件并注入路由上下文。
- 未命中进入 404 分支。
代码 / 示例
服务端路由:
/product/123 → 匹配详情组件 → 注入 param=123
未匹配 → 404 组件
常见误区
- 误区:服务端只返回首页 HTML 即可;正解:深链接需按 URL 匹配对应组件,否则刷新子页面内容错误。
- 误区:路由参数格式两端可以不同;正解:参数解析不一致会导致首屏与导航后数据对不上。
追问
- Q:服务端如何处理重定向路由? A:在渲染前匹配到重定向规则即返回跳转响应,具体 API 按框架确认。
- Q:嵌套路由在服务端如何渲染? A:按层级匹配父级与子级组件,拼接完整页面结构。
03.7.1.2-011 hydration 慢通常有哪些瓶颈?如何优化?
一句话结论
hydration 慢主要来自客户端 JS 体积、注水数据量、组件初始化与同步执行任务;优化方向是分包懒加载、减少首屏客户端代码、拆分初始化工作与按需接管,具体瓶颈需 profiling 确认。
概念解释
- JS 体积:框架运行时与首屏组件代码。
- 数据量:注水状态解析成本。
- 初始化:组件挂载时的同步计算与订阅。
原理流程
- profiling 定位 hydration 阶段长任务。
- 分析首屏 JS chunk 与注水数据。
- 分包、懒加载、延迟非关键初始化。
- 复测交互就绪时间。
代码 / 示例
优化方向:
代码分割 / 服务端组件减少客户端 JS
注水数据瘦身
初始化工作延后 / 分批接管
常见误区
- 误区:首屏 HTML 快就不需要关心 hydration;正解:交互就绪受 hydration 速度影响,慢 JS 会阻塞可交互。
- 误区:减少 JS 体积一定提升 hydration;正解:还需检查初始化逻辑与注水数据解析,体积小但任务重同样慢。
追问
- Q:如何测量 hydration 耗时? A:用浏览器性能面板与框架回调定位挂载完成节点,具体指标按监控方案确认。
- Q:非首屏组件能否延迟 hydration? A:框架支持按需/选择性接管时可延迟,具体支持范围按版本确认。
03.7.1.2-012 选择性(渐进式)hydration 是什么概念?
一句话结论
选择性 hydration 不一次性接管整棵组件树,而是按组件优先级分批加载与挂载交互;首屏关键组件先就绪,非关键组件延后,降低首屏交互阻塞。
概念解释
- 分批接管:组件按优先级进入 hydration。
- 关键优先:交互密集与首屏组件先挂载。
- 非关键延后:折叠区、弹窗、次要区块延迟。
原理流程
- 标记组件 hydration 优先级。
- 首屏关键组件先加载 JS 并接管。
- 空闲时段或交互触发时接管其余组件。
代码 / 示例
分批策略:
首屏导航/主内容 → 优先接管
弹窗/折叠/次要区块 → 空闲或触发时接管
常见误区
- 误区:所有框架默认开启选择性 hydration;正解:支持程度与 API 因框架版本而异,需查文档确认。
- 误区:延后 hydration 的区块永久无交互;正解:延后只是时机推迟,触发后仍会正常接管。
追问
- Q:如何标记组件优先级? A:使用框架提供的优先级/延迟加载 API,具体名称按版本确认。
- Q:选择性 hydration 有什么风险? A:未接管区块点击可能无响应,需保证关键交互组件优先挂载。
03.7.1.2-013 双渲染(double render)现象是什么?
一句话结论
双渲染指组件在 hydration 时因 mismatch 或状态不一致被重新挂载,首屏内容先展示后又被客户端重渲染替换,表现为闪烁、事件重置或二次加载;根因通常是两端初始状态不一致。
概念解释
- 重挂载:客户端丢弃已有 DOM 重新创建。
- 闪烁:内容或样式二次变化。
- 状态重置:首次交互绑定被打断。
原理流程
- 服务端 HTML 展示。
- 客户端初次渲染与已有 DOM 不匹配。
- 框架放弃匹配、重新渲染组件树。
- 用户看到内容替换或闪烁。
代码 / 示例
双渲染链路:
SSR HTML → 客户端状态不一致
→ mismatch → 重渲染/重挂载
→ 闪烁、事件重新绑定
常见误区
- 误区:双渲染只是多执行一次不影响体验;正解:重挂载可能导致闪烁、请求重复与交互丢失。
- 误区:双渲染由 CSS 问题引起;正解:根本原因是两端渲染结果或初始状态不一致。
追问
- Q:如何判断发生了重挂载? A:观察 DOM 节点是否被替换、挂载钩子是否多次触发,结合 profiling 确认。
- Q:重复请求如何排查? A:检查 hydration 后组件是否因状态重置重新拉取数据。
03.7.1.2-014 SSR 中错误边界与异常如何处理?
一句话结论
服务端渲染链路需捕获取数、渲染与序列化异常,按错误返回兜底页面或错误态;客户端 hydration 与后续导航用错误边界隔离组件崩溃,避免单点异常拖垮整页。
概念解释
- 服务端异常:取数失败、渲染抛错、序列化失败。
- 错误边界:客户端捕获组件渲染异常的隔离层。
- 兜底响应:错误页或降级 HTML。
原理流程
- 服务端包裹取数与渲染逻辑。
- 异常进入兜底分支,返回错误页/降级产物。
- 客户端用错误边界包裹组件树。
- 局部异常显示错误态,上报监控。
代码 / 示例
异常处理:
服务端:try/catch 取数渲染 → 兜底响应
客户端:错误边界隔离组件 → 局部错误态
常见误区
- 误区:服务端抛错直接返回 500 空白页;正解:应返回可访问的兜底内容并记录错误。
- 误区:错误边界能捕获服务端取数异常;正解:错误边界只覆盖客户端渲染,服务端异常需服务端链路处理。
追问
- Q:错误边界能捕获哪些错误? A:组件渲染与生命周期内的错误,事件回调与异步错误需另行处理,具体范围按框架确认。
- Q:SSR 序列化失败如何发现? A:注入状态前捕获序列化异常,避免页面脚本解析失败。
03.7.1.2-015 服务端组件与客户端组件的边界如何划分?
一句话结论
服务端组件在服务端执行、不进入客户端 bundle,适合取数与静态展示;客户端组件需浏览器交互与状态,必须下发 JS;边界按是否需要交互、浏览器 API 与客户端状态划分。
概念解释
- 服务端组件:服务端执行,输出标记,无客户端运行时。
- 客户端组件:下发 JS,持有状态与交互。
- 通信:服务端组件把数据传给客户端组件。
原理流程
- 判断组件是否需要交互/浏览器状态。
- 无需交互 → 服务端组件直接渲染。
- 需要交互 → 声明为客户端组件并在其中使用状态与事件。
代码 / 示例
划分参考:
数据展示、布局、取数 → 服务端组件
表单、按钮交互、状态钩子 → 客户端组件
常见误区
- 误区:服务端组件可以用浏览器事件;正解:无客户端实例,交互必须放在客户端组件中。
- 误区:服务端组件能调用客户端状态;正解:数据流由服务端向客户端组件传递,反向不直接共享。
追问
- Q:服务端组件如何传交互能力? A:通过 props 把数据与回调结构传给客户端组件,具体传参限制按框架确认。
- Q:服务端组件减少 JS 体积体现在哪里? A:其代码不打包到客户端 bundle,首屏 JS 只含客户端组件。
03.7.1.2-016 注水数据序列化有哪些安全与体积要点?
一句话结论
注水数据需转义特殊字符防止注入脚本,只传输首屏必需字段,去除函数、循环引用与冗余信息;敏感信息不应进入前端可读取的注水数据。
概念解释
- 转义:防止 JSON 嵌入 HTML 时被解析为脚本。
- 瘦身:只保留首屏渲染必需数据。
- 敏感隔离:密钥与私有数据不注入前端。
原理流程
- 选取首屏必需状态字段。
- 序列化并转义 HTML 特殊字符。
- 注入页面数据位,客户端解析恢复。
代码 / 示例
序列化要点:
转义 < > / 等字符
去除函数/循环引用/冗余字段
密钥、令牌不写入注水数据
常见误区
- 误区:直接把整份服务端状态注入 HTML;正解:冗余字段增大页面体积并暴露内部结构,应按需裁剪。
- 误区:注入 JSON 不会有 XSS 风险;正解:未转义的
</script>等字符可闭合脚本标签造成注入。
追问
- Q:注水数据如何防止 XSS? A:序列化输出转义特殊字符,避免脚本标签闭合,具体转义规则按渲染框架确认。
- Q:大对象如何避免注入 HTML? A:非首屏数据延迟到客户端请求,不进入初始注水。
03.7.1.2-017 SSR 渲染中的阻塞与长任务如何识别?
一句话结论
服务端阻塞体现在取数等待与渲染耗时,客户端阻塞体现在 hydration 同步长任务;通过分段计时与性能指标定位慢在取数、渲染还是 JS 执行,再针对性优化。
概念解释
- 服务端分段:取数、渲染、序列化。
- 客户端分段:JS 加载、hydration、初始化。
- 长任务:阻塞主线程超过阈值的同步执行。
原理流程
- 服务端记录各阶段耗时。
- 客户端用性能工具定位长任务。
- 按瓶颈优化取数并行、渲染与初始化。
代码 / 示例
分段定位:
TTFB 高 → 服务端取数/渲染慢
可交互晚 → JS 加载/hydration/初始化慢
常见误区
- 误区:SSR 慢只看 TTFB;正解:还需看客户端 hydration 与交互就绪,两段瓶颈不同。
- 误区:取数慢就换渲染模式;正解:先优化接口并发、缓存与数据量,再评估模式。
追问
- Q:服务端取数如何并行化? A:无依赖的请求并行发起,避免串行等待,具体并发控制按框架与接口确认。
- Q:客户端长任务如何拆分? A:把重计算拆到空闲时段或分块执行,避免阻塞 hydration。
03.7.1.2-018 SSR/Hydration 相关能力有哪些版本边界需要标注待确认?
一句话结论
hydration API、错误边界、服务端组件模型、选择性 hydration 与数据注水格式随框架版本变化;涉及具体函数名、默认行为与支持范围的结论标注待确认,对照版本与文档验证。
概念解释
- 版本差异:渲染 API、组件标记、数据获取方式。
- 浏览器兼容:选择性 hydration 与流式在不同环境支持不同。
- 验证:版本号 + 文档 + 最小复现。
原理流程
- 记录框架版本与目标浏览器。
- 核对服务端渲染、注水与组件 API。
- 最小样例验证 mismatch 与 hydration 行为。
代码 / 示例
待确认项:
- 服务端渲染与注水 API
- 服务端组件标记与传参规则
- 选择性 hydration 支持范围
- 错误边界 API
验证点:版本号 + 官方文档 + 最小复现样例
常见误区
- 误区:旧版教程的 hydration 写法在新版可用;正解:组件模型与 API 可能随大版本重构。
- 误区:文档描述的能力所有浏览器都支持;正解:部分特性需核对浏览器兼容范围。
追问
- Q:如何确认版本支持? A:读实际版本号,对照官方文档与迁移说明。
- Q:升级框架回归哪些项? A:SSR HTML、mismatch 警告、hydration 时机与错误边界行为。