确保客户端与服务端HTML结构一致，避免因环境差异导致重新渲染；2. 通过async/await预取数据并注入初始状态，保证数据同步；3. 使用hydrate而非render进行事件绑定，确保交互正常；4. 服务端提取样式并内联，防止客户端重排重绘。
JavaScript 的服务器端渲染（SSR）和水合（Hydration）过程虽然能提升首屏加载速度和 SEO 效果，但在实际实现中存在不少细节需要特别注意，否则容易导致页面错乱、性能下降或交互失效。
1. 保证客户端与服务端的 HTML 结构一致
水合过程依赖于客户端生成的虚拟 DOM 与服务端返回的 HTML 完全匹配。如果结构不一致，React 或 Vue 等框架会抛出警告甚至重新渲染整个组件，失去 SSR 的优势。
常见问题包括：- 服务端缺少浏览器特有的全局对象（如 window、document），导致组件渲染逻辑分支不同
- 异步数据未在服务端预取完成，造成占位符与客户端真实内容不一致
- 使用了仅客户端可用的 API（如 localStorage）在初始渲染中
2. 正确处理异步数据获取
服务端无法像浏览器一样等待数据就绪后再输出 HTML，必须在响应前完成数据预取。
需要注意：- 在路由或组件层级定义数据依赖，通过 async/await 确保数据就绪后再生成 HTML
- 将获取的数据序列化并注入到 HTML 中（如通过 window.__INITIAL_STATE__）
- 客户端初始化时优先使用注入的数据，避免重复请求
3. 水合过程中的事件绑定与脚本执行
服务端返回的是静态 HTML，所有事件监听和交互行为必须由客户端 JavaScript 在水合阶段重新绑定。
立即学习“Java免费学习笔记（深入）”；
关键点：- 确保客户端应用挂载的根节点与服务端渲染的容器 ID 完全一致
- 调用 hydrateRoot（React 18）或 app.mount(..., true)（Vue）启动水合，而非普通挂载
- 避免在水合前执行 DOM 操作，防止破坏已有的节点结构
4. 样式与资源的同步处理
服务端渲染时，CSS-in-JS 或动态样式可能未正确提取，导致客户端重新注入样式引发闪屏。
解决方案：- 在服务端收集所有用到的样式规则，并内联到 HTML 的
- 使用支持 SSR 的样式方案，如 styled-components 的 ServerStyleSheet、emotion 的 CacheProvider
- 确保字体、图片等资源路径在服务端和客户端保持一致，避免相对路径问题
基本上就这些。只要保证渲染一致性、数据可预测、资源可复用，就能让 SSR 和水合过程稳定高效地运行。
