SSR 处理 404 和 500 错误 | Quasar 框架

Quasar CLI with Vite - @quasar/app-vite

SSR 处理 404 和 500 错误

在 SSR 上处理 404 和 500 错误与其他模式（如 SPA）略有不同。如果您查看 /src-ssr/middlewares/render.js，您会注意到以下部分

export default ({ app, resolve, render, serve }) => {
  // we capture any other Express route and hand it
  // over to Vue and Vue Router to render our page
  app.get(resolve.urlPath('*'), (req, res) => {
    res.setHeader('Content-Type', 'text/html')

    render({ req, res })
      .then(html => {
        // now let's send the rendered html to the client
        res.send(html)
      })
      .catch(err => {
        // oops, we had an error while rendering the page

        // we were told to redirect to another URL
        if (err.url) {
          if (err.code) {
            res.redirect(err.code, err.url)
          }
          else {
            res.redirect(err.url)
          }
        }
        // hmm, Vue Router could not find the requested route
        else if (err.code === 404) {
          // Should reach here only if no "catch-all" route
          // is defined in /src/routes
          res.status(404).send('404 | Page Not Found')
        }
        // well, we treat any other code as error;
        // if we're in dev mode, then we can use Quasar CLI
        // to display a nice error page that contains the stack
        // and other useful information
        else if (process.env.DEV) {
          // serve.error is available on dev only
          serve.error({ err, req, res })
        }
        // we're in production, so we should have another method
        // to display something to the client when we encounter an error
        // (for security reasons, it's not ok to display the same wealth
        // of information as we do in development)
        else {
          // Render Error Page on production or
          // create a route (/src/routes) for an error page and redirect to it
          res.status(500).send('500 | Internal Server Error')
        }
      })
  })
}

上面的部分是在捕获其他可能的请求（如 /public 文件夹、manifest.json 和 service worker 等）之后编写的。这是我们使用 Vue 和 Vue Router 渲染页面的地方。

需要注意的事项

我们将讨论一些您需要注意的架构决策。选择最适合您的应用的方案。

错误 404

如果您在 Vue Router 的 /src/router/routes.js 文件中定义了一个等效的 404 路由（如下所示），那么示例中 if (err.code === 404) { 部分将永远不会为 true，因为 Vue Router 已经处理了它。

// Example of route for catching 404 with Vue Router
{ path: '/:catchAll(.*)*', component: () => import('pages/Error404.vue') }

错误 500

在页面顶部的 /src-ssr/middlewares/render.js 示例中，请注意，如果 Web 服务器遇到任何渲染错误，我们会向客户端发送一个简单的字符串（'500 | 内部服务器错误'）。如果你想显示一个漂亮的页面，你可以

在 /src/router/routes.js 中添加一个特定的路由，例如

{ path: 'error500', component: () => import('pages/Error500.vue') }

编写用于处理此页面的 Vue 组件。在此示例中，我们创建了 /src/pages/Error500.vue
然后在 /src-ssr/middlewares/render.js 中

if (err.url) { ... }
else if (err.code === 404) { ... }
else {
  // We got a 500 error here;
  // We redirect to our "error500" route newly defined at step #1.
  res.redirect(resolve.urlPath('error500')) // keep account of publicPath though!
}

警告

唯一要注意的是，你需要确保在渲染 '/error500' 路由时不会出现另一个 500 错误，否则会使你的应用程序陷入无限循环！

避免此问题的完美方法是直接从 /src-ssr/middlewares/render.js 返回 500 错误页面的 HTML（作为字符串）

res.status(500).send(`<html>....</html>`)

发现错误？在浏览器中编辑此页面

1. 简介

2. 需要注意的事项

2.1. 错误 404

2.2. 错误 500