从零开始最小实现 react 服务器渲染

前言

最近在写 koa 的时候想到，若是我部分代码提供api，部分代码支持ssr，那我应该如何写呢？（不想拆成 2个服务的状况下）

并且最近写的项目里面也用过一些服务端渲染，如nuxt，本身也搭过next的项目，确实开发体验都很是友好，可是友好归友好，具体又是如何实现的呢，诸位有没有考虑过？

本着求真务实的折腾态度，选了react做为研究对象（主要是vue写的有点多，恶心了），那下面就简单就以最小成本写一个react的服务端渲染 demo

用到的技术栈

react 16 + webpack3 + koa2

看看它是如何实现服务端渲染的，here we go！

---

为何要用服务端渲染

优势

无非就是两点

1. SEO 友好
2. 加快首屏渲染，减小白屏时间

那么问题来了什么是SEO

直接放文章不作赘述，前端后端分离，怎么解决SEO优化的问题呢？ - 知乎， 一句话介绍就是，如今咱们作的大可能是SPA网站，全部页面啊数据啊都是ajax来的，搜索引擎的spider来收录网页的时候，发现全空？那么你以为你的网站收录的权重跟效果是好仍是很差？

而咱们对SEO优化，也是下面内容所描述的核心就是：

下面是重点！

让服务器把有内容的HTML返回给咱们，事件的话浏览器再渲染一次来进行挂载
复制代码

---

搭建 koa 环境

新建一个 ssr 项目，并在项目中初始化 npm

mkdir ssr && cd ssr
npm init
复制代码

下面的代码咱们用到了 import jsx 等语法，node环境是不支持的，因此须要配置babel

在当前项目中新建文件 server.js跟index.js，而后

babel的入口， index.js代码以下

require('babel-core/register')()

require('babel-polyfill')
require('./server')

复制代码

咱们项目的入口， server.js代码以下

import Koa from 'koa'
const app = new Koa()

// response
app.use((ctx) => {
  ctx.body = 'Hello Koa'
})

app.listen(3000)
console.log("系统启动，端口：3000")

复制代码

根目录下新建一个.babelrc文件 内容是：

{
  "presets": ["react", "env"]
}
复制代码

安装上面所须要的依赖

npm install babel-core babel-polyfill babel-preset-env babel-preset-react nodemon --save-dev

npm i koa --save
复制代码

配置启动脚本

package.json

"scripts": {
  "dev": "nodemon index.js",
}
复制代码

到这里你运行 npm run dev 打开localhost:3000

你就会看到 hello Koa了

是否是很简单就起了一个服务

---

安装React

cnpm install react react-dom --save
复制代码

在根目录下新建一个app文件夹，并在文件夹中个新建一个main.js

main.js代码以下

import React from 'react'

export default class Home extends React.Component {
  render () {
    return <div>hello world</div>
  }
}
复制代码

修改以前server.js

import Koa from 'koa'
import React from 'react'
import { renderToString } from 'react-dom/server'
import App from './app/main'

const app = new Koa()

// response
app.use(ctx => {
  let str = renderToString(<App />)

  ctx.body = str
})

app.listen(3000)

console.log('系统启动，端口：8080')

复制代码

这个时候再 npm run dev 你就会看到屏幕上出现hello world

再打开chrome 开发者工具查看咱们的请求：

咱们的最简单的react组件变成str传了进来

这里咱们用到了一个方法： renderToString – 其实就是将组件渲染成字符串

目前为止，咱们都尚未给组件加上事件等交互行为，下面那让咱们来试一下

修改main.js的代码

import React from 'react'

export default class Home extends React.Component {
  render () {
    return <div onClick={() => window.alert(123)}>hello world</div>
  }
}
复制代码

再刷新一下咱们的页面，，咦，是否是没有什么卵用

那是由于后端只能讲组件渲染成一串html的字符串，事件绑定等事情都是须要在浏览器端执行的

那事件咱们改怎么绑定上去呢？

那你确定就会猜到，既然服务器渲染出来的是一串html，挂载事件的方式是否是在浏览器从新渲染一次就行了呢

说干就干

---

配制webpack

在根目录下面新建一个 webpack.config.js 下面是webpack.config.js的内容：

var path = require('path')
var webpack = require('webpack')

module.exports = {
  entry: {
    main: './app/index.js'
  },
  output: {
    filename: '[name].js',
    path: path.join(__dirname, 'public'),
    publicPath: '/'
  },
  resolve: {
    extensions: ['.js', '.jsx']
  },
  module: {
    loaders: [
      {test: /\.jsx?$/,
        loaders: ['babel-loader'],
      }
    ]
  }
}

复制代码

安装依赖

cnpm install webpack babel-loader --save
复制代码

上面的配置将entry设置成了app/index.js文件

那咱们就建立一个

下面是app/index.js的代码：

import Demo from './main'
import ReactDOM from 'react-dom'
import React from 'react'
ReactDOM.render(<Demo />, document.getElementById('root')) 复制代码

由于浏览器渲染须要将根组件挂载到某个dom节点上，因此给咱们的react代码设置一个入口

这个时候就有一个问题，就是，document对象node环境下并不存在，那怎么解决的呢？

不存在？不存在那我就不用就行了，SSR核心就是让请求的url里面返回具体HTML内容，事件什么的并不care，那么我就把根组件直接renderToString 返回出来就行了呗

下面修改咱们的服务代码，让代码支持服务器渲染

新增一点依赖

cnpm i --save koa-static koa-views ejs
复制代码

• koa-static： 处理静态文件的中间件
• koa-views： 配置模板的中间件
• ejs：一个模板引擎

修改server.js的代码

import Koa from 'koa'
import React from 'react'
import { renderToString } from 'react-dom/server'
import views from 'koa-views'
import path from 'path'

import Demo from './app/main'
const app = new Koa()
// 将/public文件夹设置为静态路径
app.use(require('koa-static')(__dirname + '/public'))
// 将ejs设置为咱们的模板引擎
app.use(views(path.resolve(__dirname, './views'), { map: { html: 'ejs' } }))

// response
app.use(async ctx => {
  let str = renderToString(<Demo />) await ctx.render('index', { root: str }) }) app.listen(3000) console.log('系统启动，端口：8080') 复制代码

下面新建咱们的渲染模板 新建一个views文件夹

里面新建一个index.html：

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <meta http-equiv="X-UA-Compatible" content="ie=edge">
    <title>Document</title>
    <base href="/client">
</head>
<body>
    <div id="root"><%- root %></div>
    <script src="/main.js"></script>
</body>
</html>
复制代码

这个 html 里面能够放一些变量，好比这个<%- root %>，就是等下要放renderToString结果的地方 /main.js则是react构建出来的代码

下面直接来测试一下咱们的代码

1. 在 package.json里面
新增：
  "scripts": {
    "dev": "nodemon index.js",
    "build": "webpack"
  },

2. 运行 npm run build， 构建出咱们的react代码

3. npm run dev

复制代码

点击一下代码，是否是会 alert(123)

:tada: 撒花，恭喜你，一个最简单服务器渲染就已经完成

到这里核心的思想就都已经讲完了，总结来讲就下面三点：

1. 起一个node服务
2. 把react 根组件 renderToString渲染成字符串一块儿返回前端
3. 前端再从新render一次

原理就是这么简单

可是具体开发的时候还会有各类各样的需求，好比：

1. 不可能我每次改完代码都从新构建看效果吧 => 须要 实时构建
2. create-react-app 都是热更新，你还要刷新是否是太蠢了 => 须要支持热更新
3. 其余一些配套的周边，如： react-router, redux 或者mobx怎么支持呢 => 须要完善的生态
4. 页面内容明明服务端已经返回给我了，客户端又从新渲染一次是否是很蠢，兰妃资源 => 使用 react 新的api .etc

这些的原理以及配置都不太难，单就是须要花点时间，因此你能够直接参考如下（大部分都是最新的配置）

更多配置

更多的配置能够参考下面的repo（是一个工具链完善的最小实现，欢迎提PR，star）

GitHub - ws456999/koa-react-ssr-starter: to understand && to explain how react ssr works

你能够在里面找到 react + react-router + mobx-state-tree + postcss + 热更新的配置，除了react-router的配置有些差异，其余都跟client端差异不大

That’s all.

参考连接

• 3-17 经过 Node.js API 启动 Webpack · 深刻浅出 Webpack
• Koa2 + React + Webpack热加载部署方案 | Nekoの喵窝
• webpack - koa服务端热更新问题 - SegmentFault
• 转 nodemon 基本配置与使用 - {前端开发} - 博客园
• React 服务端渲染缓慢缘由浅析 - 某熊的全栈之路 - SegmentFault
• ReactDOMServer - React