# 从零到一搭建React SSR工程架构|博客系列

> 本文系统介绍了React服务端渲染（SSR）与客户端渲染（CSR）的原理、区别、优缺点，并详细讲解如何从零搭建React SSR工程架构，帮助开发者提升页面首屏加载速度和SEO优化能力。

- 原文：https://feinterview.poetries.top/docs/fe-blog-docs/blog-docs/react/-%E4%BB%8E%E9%9B%B6%E5%88%B0%E4%B8%80%E6%90%AD%E5%BB%BAReact%20SSR%E5%B7%A5%E7%A8%8B%E6%9E%B6%E6%9E%84
- 来源：前端进阶之旅（feinterview.poetries.top）
- 更新：2025.10.25
- 可见范围：免费部分

---

## 一、客户端渲染与服务端渲染

### 1.1 什么是客户端渲染

> react在客户端执行，消耗客户端性能。客户端渲染，页面初始加载的` HTML` 页面中无网页展示内容，需要加载执行`JavaScript` 文件中的 `React` 代码，通过 `JavaScript` 渲染生成页面，同时，`JavaScript` 代码会完成页面交互事件的绑定，详细流程可参考下图

**客户端渲染流程**

浏览器发送请求-->服务器返回`HTML`-->浏览器发送`bundle.js`请求-->服务器返回`bundle.js`-->浏览器执行`bundle.js`中的`react`代码完成渲染

![](https://s.poetries.top/gitee/2019/10/446.png)

### 1.2 什么是服务端渲染

> `react`在服务端执行，消耗服务端性能。我们所说的服务端渲染，只是首次加载页面的时候，后面都是通过前端路由进行客户端渲染

- 用户请求服务器，服务器上直接生成 `HTML` 内容并返回给浏览器。服务器端渲染来，页面的内容是由 `Server` 端生成的。一般来说，服务器端渲染的页面交互能力有限，如果要实现复杂交互，还是要通过引入 `JavaScript` 文件来辅助实现

**服务端渲染流程**

浏览器发送请求-->服务器运行`React`代码生成页面-->服务器返回页面

### 1.3 什么是同构

> 一套react代码，在服务端执行一次，在客户端也执行一次。在服务端执行同构`renderToString`只是返回界面展示，并不能绑定事件，需要在客户端再次执行js代码绑定事件

**服务器运行`React`代码渲染出`HTML`-->发送`HTML`给浏览器-->浏览器接收到内容展示-->浏览器加载js文件-->Js中的`React`代码在浏览器端重新执行-->JS中的`React`代码接管页面操作**

**路由同构**

> 让路由在服务端、客户端各跑一遍

### 1.4 使用SSR优劣势

> 一般情况下，当我们使用 `React` 编写代码时，页面都是由客户端执行 `JavaScript` 逻辑动态挂 `DOM` 生成的，也就是说这种普通的单页面应用实际上采用的是客户端渲染模式。在大多数情况下，客户端渲染完全能够满足我们的业务需求，那为什么我们还需要 `SSR` 这种同构技术呢

- `CSR` 项目的 `TTFP`（Time To First Page）时间比较长，参考之前的图例，在 `CSR `的页面渲染流程中，首先要加载 `HTML` 文件，之后要下载页面所需的 `JavaScript` 文件，然后 `JavaScript` 文件渲染生成页面。在这个渲染过程中至少涉及到两个 `HTTP `请求周期，所以会有一定的耗时，这也是为什么大家在低网速下访问普通的 `React `或者 `Vue` 应用时，初始页面会有出现白屏的原因
- `CSR` 项目的 `SEO` 能力极弱，在搜索引擎中基本上不可能有好的排名。因为目前大多数搜索引擎主要识别的内容还是 `HTML`，对 `JavaScript` 文件内容的识别都还比较弱。如果一个项目的流量入口来自于搜索引擎，这个时候你使用 CSR 进行开发，就非常不合适了

> `SSR` 的产生，主要就是为了解决上面所说的两个问题。在 `React` 中使用 SSR 技术，我们让 React 代码在服务器端先执行一次，使得用户下载的 HTML 已经包含了所有的页面展示内容，这样，页面展示的过程只需要经历一个 `HTTP` 请求周期，`TTFP` 时间得到一倍以上的缩减

- 同时，由于 `HTML` 中已经包含了网页的所有内容，所以网页的 `SEO` 效果也会变的非常好。之后，我们让 `React` 代码在客户端再次执行，为 `HTML `网页中的内容添加数据及事件的绑定，页面就具备了 `React` 的各种交互能力

> 但是，`SSR` 这种理念的实现，并非易事。我们来看一下在 `React` 中实现 `SSR` 技术的架构图：

![](https://s.poetries.top/gitee/2019/10/447.png)

- 使用 `SSR` 这种技术，将使原本简单的 `React` 项目变得非常复杂，项目的可维护性会降低，代码问题的追溯也会变得困难
- 所以，使用 `SSR` 在解决问题的同时，也会带来非常多的副作用，有的时候，这些副作用的伤害比起 `SSR` 技术带来的优势要大的多。从个人经验上来说，我一般建议大家，除非你的项目特别依赖搜索引擎流量，或者对首屏时间有特殊的要求，否则不建议使用 `SSR`

## 二、SSR的实现本质

**SSR 之所以能够实现，本质上是因为虚拟 DOM 的存在**

1.  `SSR` 的工程中，`React` 代码会在客户端和服务器端各执行一次。你可能会想，这没什么问题，都是 JavaScript 代码，既可以在浏览器上运行，又可以在 `Node` 环境下运行。但事实并非如此，如果你的 `React` 代码里，存在直接操作 `DOM` 的代码，那么就无法实现 `SSR` 这种技术了，因为在 `Node` 环境下，是没有 `DOM` 这个概念存在的，所以这些代码在 `Node` 环境下是会报错的
2. 在 `React` 框架中引入了一个概念叫做虚拟 DOM，虚拟 DOM 是真实 DOM 的一个 JavaScript 对象映射，React 在做页面操作时，实际上不是直接操作 DOM，而是操作虚拟 DOM，也就是操作普通的 JavaScript 对象，这就使得 SSR 成为了可能。在服务器，我可以操作 JavaScript 对象，判断环境是服务器环境，我们把虚拟 `DOM` 映射成字符串输出；在客户端，我也可以操作 JavaScript 对象，判断环境是客户端环境，我就直接将虚拟 DOM 映射成真实 DOM，完成页面挂载

## 三、SSR中服务器端路由和客户端路由区别

> 实现 `React` 的 `SSR` 架构，我们需要让相同的 `React` 代码在客户端和服务器端各执行一次。大家注意，这里说的相同的 `React` 代码，指的是我们写的各种组件代码，所以在同构中，只有组件的代码是可以公用的，而路由这样的代码是没有办法公用的，大家思考下这是为什么呢？其实原因很简单，在服务器端需要通过请求路径，找到路由组件，而在客户端需通过浏览器中的网址，找到路由组件，是完全不同的两套机制，所以这部分代码是肯定无法公用。我们来看看在 SSR 中，前后端路由的实现代码

### 3.1 客户端路由

```jsx
const App = () => {
  return (
    <Provider store={store}>
      <BrowserRouter>
        <div>
          <Route path='/' component={Home}>
  		</div>
      </BrowserRouter>
    </Provider>
  )
}

ReactDom.render(<App/>, document.querySelector('#root'))
```

> 客户端路由代码非常简单，大家一定很熟悉，`BrowserRouter` 会自动从浏览器地址中，匹配对应的路由组件显示出来

### 3.2 服务器端路由

```jsx
const App = () => {
  return 
    <Provider store={store}>
      <StaticRouter location={req.path} context={context}>
        <div>
          <Route path='/' component={Home}>
        </div>
      </StaticRouter>
    </Provider>
}

Return ReactDom.renderToString(<App/>)
```

> 服务器端路由代码相对要复杂一点，需要你把 `location`（当前请求路径）传递给 `StaticRouter` 组件，这样 `StaticRouter` 才能根据路径分析出当前所需要的组件是谁。（PS：`StaticRouter` 是 `React-Router `针对服务器端渲染专门提供的一个路由组件。）

1. 通过 `BrowserRouter` 我们能够匹配到浏览器即将显示的路由组件，对浏览器来说，我们需要把组件转化成 `DOM`，所以需要我们使用 `ReactDom.render` 方法来进行 `DOM` 的挂载。而 `StaticRouter` 能够在服务器端匹配到将要显示的组件，对服务器端来说，我们要把组件转化成字符串，这时我们只需要调用 `ReactDom` 提供的 `renderToString` 方法，就可以得到 `App` 组件对应的 `HTML` 字符串。
2. 对于一个 `React` 应用来说，路由一般是整个程序的执行入口。在 `SSR` 中，服务器端的路由和客户端的路由不一样，也就意味着服务器端的入口代码和客户端的入口代码是不同的
3. 我们知道， `React` 代码是要通过 `Webpack` 打包之后才能运行的，实际上是源代码打包过后生成的代码。上面也说到，服务器端和客户端渲染中的代码，只有一部分一致，其余是有区别的。所以，针对代码运行环境的不同，要进行有区别的 `Webpack` 打包

## 四、服务端和客户端打包配置

### 4.1 客户端 Webpack 配置

```js
{
  entry: './src/client/index.js',
  output: {
    filename: 'index.js',
    path: path.resolve(__dirname, 'public')
  },
  module: {
    rules: [{
      test: /\.js?$/,
      loader: 'babel-loader'
    },{
      test: /\.css?$/,
      use: ['style-loader', {
        loader: 'css-loader',
        options: {modules: true}
      }]
    },{
      test: /\.(png|jpeg|jpg|gif|svg)?$/,
      loader: 'url-loader',
      options: {
        limit: 8000,
        publicPath: '/'
      }
    }]
  }
}
```

### 4.2 服务器端 Webpack 配置

```js
{
  target: 'node',
  entry: './src/server/index.js',
  output: {
    filename: 'bundle.js',
    path: path.resolve(__dirname, 'build')
  },
  externals: [nodeExternals()],
  module: {
    rules: [{
      test: /\.js?$/,
      loader: 'babel-loader'
    },{
      test: /\.css?$/,
      use: ['isomorphic-style-loader', {
        loader: 'css-loader',
        options: {modules: true}
      }]
    },{
      test: /\.(png|jpeg|jpg|gif|svg)?$/,
      loader: 'url-loader',
      options: {
        limit: 8000,
        outputPath: '../public/',
        publicPath: '/'
      }
    }]
  }
};
```

1. 在 `SSR` 中，服务器端渲染的代码和客户端的代码的入口路由代码是有差异的，所以在 `Webpack` 中，`Entry` 的配置首先肯定是不同的
2. 在服务器端运行的代码，有时我们需要引入 `Node` 中的一些核心模块，我们需要 `Webpack` 做打包的时候能够识别出类似的核心模块，一旦发现是核心模块，不必把模块的代码合并到最终生成的代码中，解决这个问题的方法非常简单，在服务器端的 `Webpack`配置中，你只要加入 `target: node` 这个配置即可
3. 服务器端渲染的代码，如果加载第三方模块，这些第三方模块也是不需要被打包到最终的源码中的，因为 `Node` 环境下通过 `NPM` 已经安装了这些包，直接引用就可以，不需要额外再打包到代码里。为了解决这个问题，我们可以使用 `webpack-node-externals` 这个插件，代码中的 `nodeExternals `指的就是这个插件，通过这个插件，我们就能解决这个问题。关于 `Node` 这里的打包问题，可能看起来有些抽象，不是很明白的同学可以仔细读一下 `webpack-node-externals` 相关的文章或文档，你就能很好的明白这里存在的问题了
4. 当我们的 `React` 代码中引入了一些 `CSS` 样式代码时，服务器端打包的过程会处理一遍 `CSS`，而客户端又会处理一遍。查看配置，我们可以看到，服务器端打包时我们用了 `isomorphic-style-loader`，它处理 `CSS` 的时候，只在对应的 `DOM` 元素上生成 `class` 类名，然后返回生成的 `CSS` 样式代码
5. 而在客户端代码打包配置中，我们使用了 `css-loader` 和 `style-loader`，`css-loader` 不但会在 `DOM` 上生成 `class` 类名，解析好的 `CSS` 代码，还会通过 `style-loader` 把代码挂载到页面上。不过这么做，由于页面上的样式实际上最终是由客户端渲染时添加上的，所以页面可能会存在一开始没有样式的情况，为了解决这个问题， 我们可以在服务器端渲染时，拿到 `isomorphic-style-loader` 返回的样式代码，然后以字符串的形式添加到服务器端渲染的 `HTML `之中
6. 而对于图片等类型的文件引入，`url-loader` 也会在服务器端代码和客户端代码打包的过程中分别进行打包，这里，我偷了一个懒，无论服务器端打包还是客户端打包，我都让打包生成的文件存储在 `public` 目录下，这样，虽然文件会打包出来两遍，但是后打包出来的文件会覆盖之前的文件，所以看起来还是只有一份文件
7. 如果想进行优化，你可以让图片的打包只进行一次，借助一些 `Webpack` 的插件，实现这个也并非难事，你甚至可以自己也写一个 `loader`，来解决这样的问题
8. 如果你的 `React` 应用中没有异步数据的获取，单纯的做一些静态内容展示，经过上面的配置，你会发现一个简单的 `SSR` 应用很快的就可以被实现出来了。但是，真正的一个 `React` 项目中，我们肯定要有异步数据的获取，绝大多数情况下，我们还要使用 `Redux` 管理数据。而如果想在 `SSR` 应用中实现，就不是这么简单

## 五、SSR 中异步数据的获取 + Redux 的使用

**客户端渲染中，异步数据结合 Redux 的使用方式遵循下面的流程**

- 创建 `Store`
- 根据路由显示组件
- 派发 `Action` 获取数据
- 更新 `Store` 中的数据
- 组件 `Rerender`

> 而在服务器端，页面一旦确定内容，就没有办法 Rerender 了，这就要求组件显示的时候，就要把 Store 的数据都准备好，所以服务器端异步数据结合 Redux 的使用方式

**服务器端异步数据结合 Redux流程**

- 创建 `Store`
- 根据路由分析 `Store` 中需要的数据
- 派发 `Action` 获取数据
- 更新`Store` 中的数据
- 结合数据和组件生成 `HTML`，一次性返回

### 5.1 服务器端渲染的流程

> 创建 `Store`：这一部分有坑，要注意避免，大家知道，客户端渲染中，用户的浏览器中永远只存在一个 `Store`，所以代码上你可以这么写

```js
const store = createStore(reducer, defaultState)
export default store;
```

> 然而在服务器端，这么写就有问题了，因为服务器端的 `Store` 是所有用户都要用的，如果像上面这样构建 `Store`，`Store` 变成了一个单例，所有用户共享 `Store`，显然就有问题了。所以在服务器端渲染中，`Store` 的创建应该像下面这样，返回一个函数，每个用户访问的时候，这个函数重新执行，为每个用户提供一个独立的 `Store`

```js
const getStore = (req) => {
  return createStore(reducer, defaultState);
}
export default getStore;
```

---

> 以上是免费部分。完整内容需要「前端进阶之旅」会员，原文：https://feinterview.poetries.top/docs/fe-blog-docs/blog-docs/react/-%E4%BB%8E%E9%9B%B6%E5%88%B0%E4%B8%80%E6%90%AD%E5%BB%BAReact%20SSR%E5%B7%A5%E7%A8%8B%E6%9E%B6%E6%9E%84
