在构建 Fastify 应用程序时，错误处理机制是一个重要的方面，因为它可以确保应用能够快速处理错误，并在必要时返回有意义的错误信息给用户。本文将详细介绍 Fastify 的错误处理机制，包括如何定义和处理错误，以及如何使用中间件和插件来增强错误处理能力。以下是本文的主要内容：
- 定义和处理错误
- 使用中间件和插件增强错误处理能力
- 示例代码
1. 定义和处理错误
在 Fastify 中，可以使用 reply 对象的 code 和 send 方法来定义和处理错误。例如：
fastify.get('/api/:id', async (request, reply) => {
const id = request.params.id
if (!Number.isNaN(Number(id))) {
reply.send({ id: id })
} else {
reply.code(400).send({ error: 'Invalid parameter' })
}
})在上面的示例中，当 id 不是一个数字时，将返回一个 400 的错误码和一个包含错误信息的 JSON 对象。
可以使用 throw 关键字来抛出一个错误，也可以使用 reply 对象的 send 方法将错误信息返回给客户端。例如：
// www.javascriptcn.com code example
fastify.get('/api/user/:id', async (request, reply) => {
const id = request.params.id
const user = await users.getUserById(id)
if (user) {
reply.send(user)
} else {
throw new Error('User not found')
}
})在上面的示例中，如果找不到用户，则抛出一个错误，Fastify 将使用默认的错误处理机制返回一个 500 的错误码和一个包含错误信息的 JSON 对象。
注意：throw 只能在 Promise 异步函数中使用。
2. 使用中间件和插件增强错误处理能力
Fastify 支持中间件和插件，可以使用它们来增强应用程序的错误处理能力。例如，可以使用 fastify-error-page 插件来显示错误页面：
const errorPage = require('fastify-error-page')
fastify.register(errorPage)在上面的示例中，当发生错误时，将显示一个错误页面，这有助于诊断和调试问题。
还可以使用 fastify-sensible 插件来处理常见的 HTTP 错误码：
const sensible = require('fastify-sensible')
fastify.register(sensible)在上面的示例中，Fastify 将使用内置的错误处理机制来处理常见的 HTTP 错误码，例如 404。
另一个增强错误处理能力的方法是定义一个错误处理中间件。例如：
async function errorHandler (err, request, reply) {
console.error(err)
reply.code(500).send({ error: 'Internal Server Error' })
}
fastify.setErrorHandler(errorHandler)在上面的示例中，当发生错误时，将调用 errorHandler 函数，该函数将错误信息记录到控制台并返回一个 500 的错误码和一个包含错误信息的 JSON 对象。如果有多个错误处理中间件，则可以通过设置 preValidation: true 来指定它们的调用顺序。
3. 示例代码
// www.javascriptcn.com code example
const fastify = require('fastify')()
// 定义错误处理路由
fastify.get('/api/:id', async (request, reply) => {
const id = request.params.id
if (!Number.isNaN(Number(id))) {
reply.send({ id: id })
} else {
reply.code(400).send({ error: 'Invalid parameter' })
}
})
// 抛出错误
fastify.get('/api/user/:id', async (request, reply) => {
const id = request.params.id
const user = await users.getUserById(id)
if (user) {
reply.send(user)
} else {
throw new Error('User not found')
}
})
// 中间件错误处理
async function errorHandler (err, request, reply) {
console.error(err)
reply.code(500).send({ error: 'Internal Server Error' })
}
fastify.setErrorHandler(errorHandler)
// 使用插件增强错误处理能力
const errorPage = require('fastify-error-page')
fastify.register(errorPage)
const sensible = require('fastify-sensible')
fastify.register(sensible)
fastify.listen(3000, (err) => {
if (err) {
console.error(err)
process.exit(1)
}
console.log('Server running at http://localhost:3000/')
})通过上面的代码示例，您可以快速学习 Fastify 应用程序的错误处理机制，它可以帮助您构建更健壮、更可靠的应用程序，并提供有意义的错误信息给用户。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/67d640e4a941bf7134bf2c37