Node.js 处理无效路由

在 Node.js 中，处理无效路由是一个常见的需求。当客户端请求一个不存在的路由时，我们需要返回一个合理的错误响应，而不是让它默默地失败。在本文中，我们将探讨如何使用 Node.js 处理无效路由，并提供一些最佳实践和技巧。

错误处理中间件

在 Node.js 中，我们可以使用错误处理中间件处理无效路由。错误处理中间件是一种特殊的中间件，用于处理应用程序中的错误。它们通常是最后一个中间件，当前面的所有中间件都没有处理错误时，错误处理中间件将被调用。

下面是一个简单的错误处理中间件示例：

app.use(function (err, req, res, next) {
  console.error(err.stack)
  res.status(500).send('Something broke!')
})

这个中间件将接收四个参数：错误对象、请求对象、响应对象和下一个中间件。它将输出错误栈到控制台并返回一个 500 状态码和一条错误消息。

捕获无效路由

要捕获无效路由，我们需要在错误处理中间件中添加一个条件。我们可以检查请求对象中的路由是否存在，并在路由不存在时返回一个自定义错误响应。

下面是一个示例：

app.use(function (req, res, next) {
  if (!req.route) {
    return res.status(404).send('Not Found')
  }
  next()
})

app.use(function (err, req, res, next) {
  console.error(err.stack)
  res.status(500).send('Something broke!')
})

这个中间件将检查请求对象中是否存在路由。如果路由不存在，则返回一个 404 状态码和一个“未找到”的消息。如果路由存在但遇到了其他错误，则返回一个 500 状态码和一条错误消息。

优化错误响应

为了提供更好的用户体验，我们应该尽可能详细地解释错误原因。在错误处理中间件中，我们可以根据错误类型返回不同的响应。

下面是一个示例：

app.use(function (req, res, next) {
  if (!req.route) {
    return res.status(404).json({
      error: 'Not Found',
      message: 'The requested URL ' + req.originalUrl + ' was not found on this server.'
    })
  }
  next()
})

app.use(function (err, req, res, next) {
  if (err instanceof SyntaxError) {
    return res.status(400).json({
      error: 'Bad Request',
      message: 'Invalid JSON'
    })
  }
  console.error(err.stack)
  res.status(500).json({
    error: 'Internal Server Error',
    message: 'An unexpected error occurred'
  })
})

这个中间件将返回不同的响应，具体取决于错误类型。如果请求的路由不存在，它将返回一个带有错误消息的 404 响应。如果请求的 JSON 无效，则返回一个带有错误消息的 400 响应。对于其他类型的错误，它将返回一个带有错误消息的 500 响应。

结论

处理无效路由是一个常见的需求，我们可以使用错误处理中间件来实现它。我们还可以根据错误类型返回不同的响应，以提供更好的用户体验。希望这篇文章能够帮助你更好地处理无效路由。