React SSR 服务端渲染实践指南

栏目: 服务器 · 发布时间: 5年前

内容简介：年前因为工作原因需要对原有 React 项目进行服务端渲染的改造，下面是我对之前工作经验的一些总结分享，希望可以对大家有所帮助。首先我们来了解一下 SSR 可以做什么，可以解决什么问题，诞生的原因又是什么。接下来是它到底长什么样子，最然后再是怎么做。需要提前明确的一点是 SSR 并不是万能的，它有它的优缺点和具体的适用场景，我们先来看一下它诞生的历史背景。现如今 SPA 单页面应用已成为主流，相关的开发工具和 MVVM 框架为前端的开发带来了便利和无限的可能性。我们在体验着 SPA 页面开发便捷性的同时，随

年前因为工作原因需要对原有 React 项目进行服务端渲染的改造，下面是我对之前工作经验的一些总结分享，希望可以对大家有所帮助。

适用场景

首先我们来了解一下 SSR 可以做什么，可以解决什么问题，诞生的原因又是什么。接下来是它到底长什么样子，最然后再是怎么做。需要提前明确的一点是 SSR 并不是万能的，它有它的优缺点和具体的适用场景，我们先来看一下它诞生的历史背景。

产生的原因

现如今 SPA 单页面应用已成为主流，相关的开发 工具 和 MVVM 框架为前端的开发带来了便利和无限的可能性。我们在体验着 SPA 页面开发便捷性的同时，随着业务的发展下面的两个问题也会逐渐暴露出来，而且是在原有模式下很难解决的。

发现的问题

  • 首屏白屏时间过长。在常规 SPA 的页面渲染流程中，首先要加载 HTML 文件，之后要下载页面所需的 JavaScript 文件，然后 JavaScript 文件渲染生成页面， 如果有涉及到数据请求，那么这个耗时将会更加漫长，尤其是在弱网环境下，体验非常糟糕。

  • SEO 能力较弱。因为目前大多数搜索引擎主要识别的内容还是 HTML，对 JavaScript 文件内容的识别都还比较弱，所以很难在搜索引擎中有较好的排名。

技术原理

SSR 技术随之应运而生，SSR 全称 Server Side Rendering 。以 React 为例，首先我们让 React 代码在服务器端先执行一次，使得用户下载的 HTML 已经包含了所有的页面展示内容，同时，由于 HTML 中已经包含了网页的所有内容，所以网页的 SEO 效果也会变的非常好。之后，我们让 React 代码在客户端再次执行，为 HTML 网页中的内容添加数据及事件的绑定，页面就具备了 React 的各种交互能力，可参考下图。

React SSR 服务端渲染实践指南

核心 API：

服务端： renderToString() | ReactDOMServer.renderToNodeStream()

生成带有标记的 html 文档结构

客户端： ReactDOM.hydrate()

根据服务端携带的标记更新 React 组件树，并附加事件响应

SSR 的劣势

技术改造成本相对较高，node 服务器端的资源前端不太好驾驭。

所以我个人的建议，是要慎重评估改造的成本和收益，不推荐在生产项目中直接使用

可用于替代的相关技术

  1. 骨架屏 Skeleton

  2. 预渲染 Pre-render

    这项技术主要用来解决 SEO 的问题，适用于短时间内不会产生频繁变动的网页。可在服务器端判断 UA，针对爬虫单独返回提前手动抓取好的 html 内容。

  3. next.js (新的项目)

  4. Jquery (交互较少的页面)

项目结构

SSR Project
├─build
|  ├─client
|  ├─server
|  └assets.json
├─node_modules
├─public  //公共资源
├─components
├─webpack  //打包配置
|  ├─webpack.config.js
|  ├─webpack.client.config.js
|  └webpack.server.config.js
├─server  //服务端代码
|  ├─App.jsx
|  ├─router.js
|  └index.js
├─src  //客户端代码
|  ├─pages
|  ├─App.jsx
|  ├─router.js
|  └index.js
├─index.html
├─server.js  //服务端入口文件
├─package.json
复制代码

基础配置

现在我们来从头搭建一个 React 服务端的渲染环境。先来看一下最终结果，下面是一份服务端返回 HTML 的 template 页面示例

<!DOCTYPE html>
<html lang="cn">
  <head>
    <meta charset="utf-8" />
    <meta
      name="viewport"
      content="width=device-width,height=device-height,maximum-scale=1.0,user-scalable=no;"
    />
    <link href="/main.css" rel="stylesheet" />
  </head>
  <body>
    <div id="root">
      {serverContent}
    </div>
    <script type="text/javascript" src="/bundle.js"></script>
  </body>
</html>
复制代码

其实对比原有项目改动很简单，就是把 root 节点内的 html 内容提前在服务端渲染成字符串拼接到模板内。我们采用 express 搭建 node 服务。

server/index.js

import React from 'react'
import renderToString from 'reactDOM/server'
import express from 'express'
import App from './App'
const app = express()

app.get('/', (req, res, next) => {
  const serverContent = renderToString(<App/>)
  const html = mixin(template,serverContent)
  res.send(html)
})

// 导出启动服务的函数供入口文件调用
export default startServer() => {
  app.listen('3000')
  return app
}
复制代码

server.js

var startServer = require("./build/server/index.js");
startServer();
复制代码

接下来我们要修改 webpack.server.config.js, 将 server 端代码编译成可以被 commonjs 模块系统识别的代码

{
  ...
  input: path.resolve(__dirname, '..', 'server/index.js'),
  output: path.resolve(__dirname, '..', 'build/server,'),
  target: 'node',
  ...
}
复制代码

这样服务端基础代码就完成了，但这样是远远不够的，我们还需要做一些其他的处理。

静态资源

接下来我们处理静态资源。生产环境的 js bundle 和 css file 都将会附带哈希值，如果按照现在这样简单地在服务端模板内引入 "/bundle.js" 是找不到文件的，正确的引入路径应该是 "/bundle_[hash].js" 。那么下面我们来套路如何处理哈希同步的问题，其次图片资源我们也希望不要重复生成两份哈希。

这里推荐使用 universal-webpack， 它通过帮我们修改 webpack 配置的方式，帮我们解决上述的问题。插件在打包时会在 build 目录下生成 assets.json 资源定位文件，服务端我们引入这个文件处理即可。

详细项目文档

assets.json

interface Chunks {
  javascript: {
    [scriptname: string]: string;
  };
  styles: {
    [scriptname: string]: string;
  };
}
复制代码

webpack.client.config.js

import { clientConfiguration } from 'universal-webpack'
const webpackConfig = {...}

return clientConfiguration(webpackConfig, {
    chunk_info_filename: 'assets.json'
}, {
  useMiniCssExtractPlugin : true
})
复制代码

webpack.server.config.js

import { serverConfiguration } from 'universal-webpack'
const webpackConfig = {...}

return serverConfiguration(webpackConfig, {
  // 默认第三方模块都不打包，这里需要配置不支持commonjs的第三方模块
  excludeFromExternals: [
    'lodash-es',
    /^some-other-es6-only-module(\/.*)?$/
  ],

  // 这里配置不需要重复打包的文件
  loadExternalModuleFileExtensions: [
    'css',
    'png',
    'jpg',
    'svg',
    'xml'
  ]
})
复制代码

改造 server/index.js

const assets = require("../assets.json");
const js = Object.values(assets.javascript)
  .map(item => <link rel="stylesheet" href="${item}" />)
  .join("\n");
const css = Object.values(assets.styles)
  .map(item => `<script src="${item}"></script>`)
  .join("\n");

const html = mixin(template, {
  js,
  css,
  serverContent
});
复制代码

路由处理

我们需要在服务端根据请求的 url 渲染对应的组件，这里和客户端稍微有一些不太一样。react-router 提供了 StaticRouter 组件用于服务端渲染，我们可以手动传入请求的的 url 来进行路由定位。

server/index.js

app.get("/", (req, res, next) => {
  ...
  // @override
  // const serverContent = renderToString(<App/>)
  const url = req.url; // "/home"
  const serverContent = renderToString(<App url={url} />);
  ...
});
复制代码

server/App.jsx

import React from 'react'
import { StaticRouter, Switch, Route } from 'react-router-dom'
import routes from './router.js'

export default App(props)  => {
  <StaticRouter location={props.url} context={{}}>
     <Switch>
       {routes.map((route) => {
         <Route {...route} />
       })}
     </Swtich>
  </StaticRouter>
}
复制代码

数据获取

我们一般在 componentDidMount 生命周期执行获取数据的方法，但是在服务端环境中生命周期是不完整的，只会执行 ComponentWillMount 之前的方法，所以我们必须在渲染前准备好数据，然后通过 props 注入到组件中。

这里我们为路由组件定义了一个 loadData 的钩子函数，通过 react-router 提供的 matchPath 方法，可以判断当前需要渲染的页面组件，并执行相应的 loadData 方法获取数据，该方法返回一个 Promise 对象，以便我们在数据获取成功后异步执行渲染逻辑。

server/router.js

// 这里可以通过客户端路由文件改造, 添加需要的loadData方法即可
const routes = {
  path: "/",
  component: Home,
  //  return a Promise
  loadData: () => getSomeData()
};
复制代码

server/index.js

import { matchPath } from 'react-router-dom'

app.get('/', (req, res, next) => {
  ...
  const promise = Promise.resolve()
  routes.find(route => {
    const match = matchPath(req.url, route)
    if(match) promise.then(route.loadData)
    return match
  })
  promise.then((data) => {
      const serverData = formatData(data)
      // @override
      // const serverContent = renderToString(<App url={url} />);
      const serverContent = renderToString(<App url={req.url} data={serverData}/>)
      const html = mixin(template, {js, css, serverContent})
      res.send(html)
  })
})
复制代码

server/App.jsx

export default App(props)  => {
  <StaticRouter location={props.url} context={{}}>
     <Switch>
       {routes.map((route) => {
         <Route {...route} render={() => {
           const Component = route.component
           <Component data={props.data}/>
         }}/>
       })}
     </Swtich>
  </StaticRouter>
}
复制代码

使用 Redux

如果使用 redux 管理同构的数据则会方便许多，这里注意每一个请求都需要重新生成一个新的 store，否则的话用户状态则会混乱。

server/App.jsx

export default App(props)  => {
   <Provider store={props.store}>
    <StaticRouter location={props.url} context={{}}>
      <Switch>
        {routes.map((route) => {
          <Route {...route} />
        })}
      </Swtich>
    </StaticRouter>
  </Provider>
}
复制代码

server/index.js

...
promise.then((data) => {
  ...
  const preloadedState = mixin(initData, data)
  const store = createStore(reducers, preloadedState)
  // @override
  // const serverContent = renderToString(<App url={req.url} data={serverData}/>)
  const serverContent = renderToString(<App url={req.url} store={store}/>)
  ...
})
...
复制代码

客户端数据同步

至此为止，服务器端最终会输出一个带有数据状态的完整页面。但是客户端这边重新渲染的时候，首先会渲染一个没有数据的框架，然后才会在 componentDidMount 里发起数据接口请求数据，这意味着在这个过程期间客户端都为空数据状态，在用户看来就是表现为会执行重复地 loading 。

所以我们希望客户端可以共享服务端已经获取的数据，我的解决办法是在服务端将数据注入到 HTML 中返回给客户端 脱水 (Dehydrate)。在浏览器端，客户端不再自己发起请求获取数据处理状态，直接使用脱水数据来初始化 React 组件 注水 (Hydrate)

React SSR 服务端渲染实践指南

HTML 模板

...
    </div>
    <script type="text/javascript" src="/bundle_[hash].js"></script>
    <script>window.__initState__ = ${JSON.stringfy(store)}</script>
  </body></html>
复制代码

server/index.js

// @override
  // const html = mixin(template, {js, css, serverContent})
  const html = mixin(template, {js, css, serverContent, store})
})
复制代码

客户端初始化数据

store.js

const defaultState = JSON.parse(window.__initState__);
const store = createStore(reducer, defaultState);
复制代码

以上所述就是小编给大家介绍的《React SSR 服务端渲染实践指南》，希望对大家有所帮助，如果大家有任何疑问请给我留言，小编会及时回复大家的。在此也非常感谢大家对 码农网 的支持！

查看所有标签

猜你喜欢:

本站部分资源来源于网络，本站转载出于传递更多信息之目的，版权归原作者或者来源机构所有，如转载稿涉及版权问题，请联系我们。

码农书籍
文明之光 （第三册）

文明之光 （第三册）

吴军 / 人民邮电出版社 / 2015-1-1 / 59

【《文明之光》系列荣获由中宣部、中国图书评论学会和中央电视台联合推选的2014“中国好书”奖】 吴军博士从对人类文明产生了重大影响却在过去被忽略的历史故事里，选择了有意思的几十个片段特写，以人文和科技、经济结合的视角，有机地展现了一幅人类文明发展的宏大画卷。 《文明之光 》系列大致按照从地球诞生到近现代的顺序讲述了人类文明进程的各个阶段，每个章节相对独立，全景式地展现了人类文明发展历程......一起来看看 《文明之光 （第三册）》 这本书的介绍吧!

码农工具
HTML 编码/解码
HTML 编码/解码

HTML 编码/解码

URL 编码/解码
URL 编码/解码

URL 编码/解码

MD5 加密
MD5 加密

MD5 加密工具

  • New
  • 文章
  • 话题
  • 教程
    • 关注 码农网 公众号
    版权所有，保留一切权利！© 2018-2024 码农网 粤ICP备17054400号-3