用途:面向 Fastify 5 的实践指南与 API 参考,用于编写新路由、审查服务端代码、排查请求生命周期与插件作用域问题。
主要能力:给出请求生命周期的精确顺序(路由→onRequest→preParsing→内容解析→preValidation→Schema 校验→preHandler→处理器→preSerialization→onSend→响应→onResponse,任一步出错进入 onError→错误处理器→onSend→响应→onResponse);列出常见反模式,如 async 与回调混用、async 处理器返回 undefined、需要 this 时用箭头函数、忘记 fastify-plugin 包装、直接用引用类型装饰导致跨请求共享同一对象、在 onError 中发送响应、async 钩子中 reply.send() 后未 return reply、忽视封装、用路由参数拼接 SQL、缺少响应 schema;并提供插件、带校验路由、应用级钩子、错误处理器的快速模式,以及按主题拆分的参考文件(服务器与选项、路由与处理器、钩子与生命周期、插件与封装、校验与序列化、请求/回复与错误、TypeScript 与日志)。
使用方式:按需加载对应参考文件获取详细 API;项目约定使用 FastifyPluginCallback 加 done() 编写插件。
限制:资料未提供安装命令、版本兼容范围、性能数据与收费信息。