0

0

如何构建一个支持SSR(服务端渲染)的React应用?

紅蓮之龍

紅蓮之龍

发布时间:2025-10-03 15:51:02

|

931人浏览过

|

来源于php中文网

原创

答案:构建SSR应用需在服务端用renderToString生成HTML,客户端用hydrateRoot激活交互,通过StaticRouter实现服务端路由匹配,并预取数据注入__INITIAL_STATE__实现状态同步。

如何构建一个支持ssr(服务端渲染)的react应用?

要构建一个支持SSR(服务端渲染)的React应用,核心在于让组件既能在服务端生成HTML字符串,又能在客户端正确“注水”(hydrate),保持交互性。关键点是使用Node.js服务器配合React的 renderToStringhydrateRoot 方法,并确保两端路由和状态同步。

1. 搭建基础服务端入口

创建一个基于Express或Koa的Node.js服务器,在请求到来时调用React进行渲染。

• 使用 react-dom/server 中的 renderToString 将React组件转换为HTML字符串
• 将生成的HTML嵌入到完整的页面模板中,包含必要的script标签
• 返回拼接后的HTML响应给客户端

示例代码片段:

import { renderToString } from 'react-dom/server';
import App from './App';

app.get('*', (req, res) => {
  const html = renderToString();
  res.send(`
    
    
      SSR App
      
${html}
`); });

2. 客户端启用hydrate激活页面

服务端渲染只生成静态HTML,必须在客户端通过hydrate使组件具备交互能力。

• 在客户端入口文件中,使用 hydrateRoot 而不是 createRoot
• 确保客户端挂载的目标元素ID与服务端一致(如 #root)
• hydrate会复用已有的DOM节点,绑定事件监听器

客户端代码示例:

网商宝商城管理系统
网商宝商城管理系统

网商宝开源版商城系统是一款免费的通用电子商务平台构建软件,使用她您可以非常方便的开一个网上商店,在网上开展自己的生意。网商宝商城管理系统有如下特点:1、功能的 AJAX 化 完美结合ASP.NET的AJAX技术,大幅减少了网络数据传输量,加快了页面操作的响应速度,减少了服务器负担,且用户操作体验更加美好,安全性更高,易用性更强。2、基于规则的权限控制 权限管理模块提供强大的权限控制,支持多用户操作

下载
import { hydrateRoot } from 'react-dom/client';
import App from './App';

hydrateRoot(document.getElementById('root'), );

3. 处理路由和服务端匹配

如果使用React Router,服务端需根据请求URL匹配对应路由,避免返回首页内容。

• 使用 StaticRouter 替代 BrowserRouter 在服务端运行
• 传入当前请求路径(req.url)作为location信息
• 结合 useRoutesRoutes/Route 实现动态匹配

服务端路由处理示意:

import { StaticRouter } from 'react-router-dom/server';
import { useRoutes } from 'react-router-dom';
import routes from './routes';

function App() {
  return useRoutes(routes);
}

// 服务端渲染时
const html = renderToString(
  
    
  
);

4. 数据预取与状态同步

服务端渲染常需要先获取数据再输出HTML,否则会出现内容闪烁。

• 在组件设计上支持异步数据加载(如自定义loadData函数)
• 服务端等待数据获取完成后再执行renderToString
• 将初始状态序列化后注入window.__INITIAL_STATE__,供客户端复用

简单实现方式:

// 服务端
const preloadedState = await fetchSomeData();
const html = renderToString();

res.send(`
  ...
  
`);
基本上就这些。只要把握住服务端生成HTML、客户端hydrate、路由匹配和数据同步这几个关键环节,就能搭建出一个基本可用的SSR应用。实际项目中可考虑使用Next.js来简化流程。

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
js 字符串转数组
js 字符串转数组

js字符串转数组的方法:1、使用“split()”方法;2、使用“Array.from()”方法;3、使用for循环遍历;4、使用“Array.split()”方法。本专题为大家提供js字符串转数组的相关的文章、下载、课程内容,供大家免费下载体验。

298

2023.08.03

js截取字符串的方法
js截取字符串的方法

js截取字符串的方法有substring()方法、substr()方法、slice()方法、split()方法和slice()方法。本专题为大家提供字符串相关的文章、下载、课程内容,供大家免费下载体验。

212

2023.09.04

java基础知识汇总
java基础知识汇总

java基础知识有Java的历史和特点、Java的开发环境、Java的基本数据类型、变量和常量、运算符和表达式、控制语句、数组和字符串等等知识点。想要知道更多关于java基础知识的朋友,请阅读本专题下面的的有关文章,欢迎大家来php中文网学习。

1500

2023.10.24

字符串介绍
字符串介绍

字符串是一种数据类型,它可以是任何文本,包括字母、数字、符号等。字符串可以由不同的字符组成,例如空格、标点符号、数字等。在编程中,字符串通常用引号括起来,如单引号、双引号或反引号。想了解更多字符串的相关内容,可以阅读本专题下面的文章。

623

2023.11.24

java读取文件转成字符串的方法
java读取文件转成字符串的方法

Java8引入了新的文件I/O API,使用java.nio.file.Files类读取文件内容更加方便。对于较旧版本的Java,可以使用java.io.FileReader和java.io.BufferedReader来读取文件。在这些方法中,你需要将文件路径替换为你的实际文件路径,并且可能需要处理可能的IOException异常。想了解更多java的相关内容,可以阅读本专题下面的文章。

613

2024.03.22

php中定义字符串的方式
php中定义字符串的方式

php中定义字符串的方式:单引号;双引号;heredoc语法等等。想了解更多字符串的相关内容,可以阅读本专题下面的文章。

588

2024.04.29

go语言字符串相关教程
go语言字符串相关教程

本专题整合了go语言字符串相关教程,阅读专题下面的文章了解更多详细内容。

170

2025.07.29

c++字符串相关教程
c++字符串相关教程

本专题整合了c++字符串相关教程,阅读专题下面的文章了解更多详细内容。

83

2025.08.07

Python 自然语言处理(NLP)基础与实战
Python 自然语言处理(NLP)基础与实战

本专题系统讲解 Python 在自然语言处理(NLP)领域的基础方法与实战应用,涵盖文本预处理(分词、去停用词)、词性标注、命名实体识别、关键词提取、情感分析,以及常用 NLP 库(NLTK、spaCy)的核心用法。通过真实文本案例,帮助学习者掌握 使用 Python 进行文本分析与语言数据处理的完整流程,适用于内容分析、舆情监测与智能文本应用场景。

10

2026.01.27

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
React 教程
React 教程

共58课时 | 4.2万人学习

国外Web开发全栈课程全集
国外Web开发全栈课程全集

共12课时 | 1.0万人学习

React核心原理新老生命周期精讲
React核心原理新老生命周期精讲

共12课时 | 1万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号