logologo
文档仓库
文档仓库
logologo
开始

概述

第一步
控制器
提供者
模块
中间件
异常过滤器
管道
守卫
拦截器
自定义装饰器

基础

自定义提供程序
异步提供者
动态模块
注入作用域
循环依赖
模块引用
懒加载模块
执行上下文
生命周期事件
发现服务
平台无关
单元测试

技术

配置
SQL
Mongo
验证
缓存
序列化
版本控制
任务调度
队列
日志
Cookies
事件
压缩
文件上传
文件流
HTTP 模块
Session
MVC
性能(Fastify)
SSE

安全

认证
授权
加密与哈希
Helmet
CORS
CSRF
速率限制

GraphQL

快速开始
解析器
变更
订阅
标量
指令
接口
联合与枚举
字段中间件
类型映射
插件
复杂度
扩展
CLI 插件
生成SDL
共享模型
其他功能
联邦

WebSocket

网关
异常过滤器
管道
守卫
拦截器
适配器

微服务

基础
Redis
MQTT
NATS
RabbitMQ
Kafka
gRPC
自定义传输
异常过滤器
管道
守卫
拦截器
部署
独立应用程序

CLI

概述
工作区
库
用法
脚本

OpenAPI

介绍
装饰器
类型映射
操作
其他特性
安全
类型与参数
CLI 插件

实用示例

REPL
CRUD生成器
SWC
Passport(认证)
热重载
MikroORM
TypeORM
Mongoose
Sequelize
路由模块
Swagger
健康检查
CQRS
Compodoc
Prisma
Sentry
静态资源
Commander
异步本地存储
Necord
套件(原Automock)

常见问题

Serverless
HTTP 适配器
长连接
全局前缀
原始请求体
混合应用
HTTPS & 多服务器
请求生命周期
错误

开发工具

概述
CI/CD
迁移指南
API参考(官方)

生态与案例

谁在用
精彩资源

支持

支持

社区

贡献者

最后更新于: 2025/11/18 02:11:37

上一页MVC
下一页SSE

#性能(Fastify)

默认情况下,Nest 使用 Express 框架。如前所述,Nest 也兼容其他库,例如 Fastify。Nest 通过实现框架适配器来达成这种框架无关性,该适配器的主要功能是将中间件和处理器代理到相应库的特定实现。

注意

要实现框架适配器,目标库必须提供与 Express 类似的请求/响应管道处理机制。

Fastify 是 Nest 的绝佳替代框架,因为它以类似 Express 的方式解决设计问题。但 fastify 比 Express 快得多 ,基准测试结果几乎快两倍。一个合理的问题是:为什么 Nest 默认使用 Express 作为 HTTP 提供者?原因是 Express 使用广泛、知名度高,并拥有大量兼容中间件,这些都可以被 Nest 用户直接使用。

但由于 Nest 提供了框架无关性,您可以轻松在不同框架间迁移。当您非常注重极高性能时,Fastify 可能是更好的选择。要使用 Fastify,只需如本章所示选择内置的 FastifyAdapter 即可。

#安装

首先,我们需要安装所需的包:

$ npm i --save @nestjs/platform-fastify

#适配器

安装 Fastify 平台后,我们就可以使用 FastifyAdapter 了。

main.ts
import { NestFactory } from '@nestjs/core';
import {
 FastifyAdapter,
 NestFastifyApplication,
} from '@nestjs/platform-fastify';
import { AppModule } from './app.module';

async function bootstrap() {
 const app = await NestFactory.create<NestFastifyApplication>(
   AppModule,
   new FastifyAdapter()
 );
 await app.listen(process.env.PORT ?? 3000);
}
bootstrap();

默认情况下,Fastify 仅监听 localhost 127.0.0.1 接口( 了解更多 )。若需接受其他主机的连接,应在 listen() 调用中指定 '0.0.0.0':

async function bootstrap() {
  const app = await NestFactory.create<NestFastifyApplication>(
    AppModule,
    new FastifyAdapter()
  );
  await app.listen(3000, '0.0.0.0');
}

#平台特定包

请注意,当使用 FastifyAdapter 时,Nest 会将 Fastify 作为 HTTP 提供程序 。这意味着所有依赖 Express 的方案可能不再适用,而应改用 Fastify 的等效包。

#重定向响应

Fastify 处理重定向响应的方式与 Express 略有不同。要进行正确的重定向,需同时返回状态码和 URL,如下所示:

@Get()
index(@Res() res) {
  res.status(302).redirect('/login');
}

#Fastify 配置选项

您可以通过 FastifyAdapter 构造函数将选项传入 Fastify。例如:

new FastifyAdapter({ logger: true });

#中间件

中间件函数获取的是原始的 req 和 res 对象,而非 Fastify 的封装对象。这是底层使用的 middie 包以及 fastify 的工作机制 - 更多信息请参阅此页面

logger.middleware.ts
import { Injectable, NestMiddleware } from '@nestjs/common';
import { FastifyRequest, FastifyReply } from 'fastify';

@Injectable()
export class LoggerMiddleware implements NestMiddleware {
 use(req: FastifyRequest['raw'], res: FastifyReply['raw'], next: () => void) {
   console.log('Request...');
   next();
 }
}

#路由配置

你可以使用 Fastify 的路由配置功能,配合 @RouteConfig() 装饰器。

@RouteConfig({ output: 'hello world' })
@Get()
index(@Req() req) {
  return req.routeConfig.output;
}

#路由约束

自 v10.3.0 版本起,@nestjs/platform-fastify 支持 Fastify 的路由约束功能,通过 @RouteConstraints 装饰器实现。

@RouteConstraints({ version: '1.2.x' })
newFeature() {
  return 'This works only for version >= 1.2.x';
}
提示

@RouteConfig() 和 @RouteConstraints 是从 @nestjs/platform-fastify 导入的。

#示例

一个可用的示例在此处查看。