如何在 Vue 3 中使用 SSR

How to use SSR with Vue 3

我有一个可以运行的 Vue 2 应用程序,具有服务器端渲染功能。现在我正在尝试升级到 Vue 3 但卡在 SSR 部分因为 vue-server-renderer 包抛出以下错误:

Vue packages version mismatch: - vue@3.0.0 - vue-server-renderer@2.6.12 This may cause things to work incorrectly. Make sure to use the same version for both.

但是vue-server-renderer没有3.0.0版本...

通过谷歌搜索,我在 vue-next 存储库中发现了这个问题:https://github.com/vuejs/vue-next/issues/1327

但是对于我来说还是不清楚如何用vue.3版本实现SSR。已经可以了吗?是否有如何在 Vue 3 中使用 SSR 的示例?

Vue-server-renderer 只能与 vue 版本 2 一起使用。版本 3 的一大变化是它现在内置了 SSR 支持。

因此,您现在只需使用 vue 的 createSSRApp,而不是使用 vue-2.0 server-renderer。 在服务器上,要将这样创建的应用程序呈现为可以发送到浏览器的字符串,您可以使用 renderToString 方法,您可以从 @vue/server-renderer 导入该方法(请注意,您必须单独安装此包).

作为一个超级基本的(没有捆绑器或任何东西)示例,这看起来像这样:

const express = require('express');
const { createSSRApp } = require('vue');
const { renderToString } = require('@vue/server-renderer');

const app = express();

const example= {
  template: `
    <div>
      Hello World
    </div>`,
};

function renderVueApp(req, res) {
  const vueApp = createSSRApp(example);

  (async () => {
    const html = await renderToString(vueApp);

    res.send(`
      <!DOCTYPE html>
      <html lang="en">
        <head>
          <meta charset="UTF-8">
          <meta name="viewport" content="width=device-width, initial-scale=1.0">
          <script src="https://unpkg.com/vue@next"></script>
          <title>About blank</title>
        </head>
        <body>
          <div id="app">${html}</div>
          <script>
            const example = { template: '<div>Hello World</div>}; 
            Vue.createSSRApp(example).mount('#app', true);
          </script>
        </body>
      </html>
    `);
  })();
}

app.get('/', renderVueApp);

const port = process.env.PORT || 8080;
app.listen(port, () =>
  console.log(`Server started at localhost:${port}. Press ctrl+c to quit.`)
);

在 front-end 中,您让 vue 接管来自服务器的标记,即您在水化模式下创建和安装应用程序。

您在问题中引用的包渲染器或多或少只是从 vue-2.0 server-renderer 中提取的。为了使用它,你必须使用 vue-2.0 server-renderer 包中的 client-plugin 和 server-plugin 并将它们插入到你的 webpack 进程中以获得 server-bundle 和客户端清单。

请注意,使用此设置,捆绑渲染器将仅注入 entry/initial 带有 rel="preload" 的脚本。现在,'new' vue-loader 不会将任何组件注册逻辑注入组件(就像 'old' vue 加载器那样)。不过,vue-bundle-renderer 可以并且将会使用 rel="preload" 注入异步块,只要它们在 ssrContext._registeredComponents 中被引用。因此,如果您的应用程序需要此功能,则必须自己编写该逻辑。

当然,这是一种方法。我敢肯定还有很多路通向同一个目的地。

我写了一个 vue3 版本的 vue2 hackernews 克隆,它使用了所有描述/提到的东西。

您可以在这里找到它:https://github.com/raukaute/vue-hackernews-3.0