【Nest】中间件

一、中间件的创建与使用

1. 类中间件

通过实现 NestMiddleware 接口创建类中间件,需定义 use 方法:

typescript 复制代码
import { Injectable, NestMiddleware } from '@nestjs/common';
import { Request, Response, NextFunction } from 'express';

@Injectable()
export class LoggerMiddleware implements NestMiddleware {
  use(req: Request, res: Response, next: NextFunction) {
    console.log(`[${new Date().toISOString()}] Request to: ${req.path}`);
    next(); // 必须调用 next() 传递请求
  }
}

注册方式 :在模块中通过 MiddlewareConsumer 配置作用范围:

typescript 复制代码
import { Module, NestModule, MiddlewareConsumer } from '@nestjs/common';

@Module({})
export class AppModule implements NestModule {
  configure(consumer: MiddlewareConsumer) {
    consumer
      .apply(LoggerMiddleware)
      .forRoutes('*'); // 应用到所有路由,或指定控制器/路径
      // 可以指定路由路径方法 或者 某个控制器类
      // forRoutes({path:'user',method:RequestMethod.GET})
      // forRoutes(UserController)
  }
}

2. 函数中间件

更轻量的方式,直接定义函数:

typescript 复制代码
export function logger(req: Request, res: Response, next: NextFunction) {
  console.log(`Request URL: ${req.url}`);
  next();
}

注册方式与类中间件相同。


二、全局中间件

全局中间件对所有路由生效,但仅支持函数形式 。需在 main.ts 中配置:

typescript 复制代码
import { NestFactory } from '@nestjs/core';
import { AppModule } from './app.module';
import * as cors from 'cors';

async function bootstrap() {
  const app = await NestFactory.create(AppModule);
  // 应用全局中间件
  app.use(LoggerMiddleware); 
  await app.listen(3000);
}
bootstrap();

注意 :类中间件若需全局生效,需在模块中配置 forRoutes('*')。


三、使用第三方中间件(以 CORS 为例)

bash 复制代码
npm install cors

npm install @types/cors -D

1. 通过 NestJS 内置模块

在 main.ts 中启用:

typescript 复制代码
import { NestFactory } from '@nestjs/core';
import { AppModule } from './app.module';

async function bootstrap() {
  const app = await NestFactory.create(AppModule);
  // 配置 CORS
  app.enableCors({
    origin: 'http://localhost:3000', // 允许的域名
    methods: 'GET,POST',            // 允许的请求方法
  });
  await app.listen(3000);
}
bootstrap();

2. 直接使用 Express 中间件

例如使用 cors 包:

typescript 复制代码
import * as cors from 'cors';

async function bootstrap() {
  const app = await NestFactory.create(AppModule);
  app.use(cors()); // 应用第三方中间件
  await app.listen(3000);
}

此方式更灵活,支持原生 Express 中间件的所有配置项。


四、高级用法示例

1. 多个中间件链式调用

typescript 复制代码
consumer
  .apply(Middleware1, Middleware2)
  .forRoutes(UserController);

中间件按顺序执行,若某个中间件未调用 next(),后续中间件和路由处理将终止。

2. 动态中间件配置

通过工厂函数传递参数:

typescript 复制代码
// 定义中间件生成函数
export function rateLimiter(options) {
  return (req, res, next) => {
    // 根据 options 实现限速逻辑
    next();
  };
}

// 注册时传入参数
consumer.apply(rateLimiter({ windowMs: 15000, max: 100 })).forRoutes('*');

总结

类型 适用场景 特点
类中间件 复杂逻辑、依赖注入 支持模块化配置,可复用性高
函数中间件 简单逻辑、快速实现 无需类结构,轻量级
全局中间件 跨路由统一处理(如日志) 仅函数形式,需在入口文件配置
第三方中间件 跨域、限速等通用功能 直接复用 Express 生态
相关推荐
飞奔的瓜牛1 天前
Kafka 生产实践指南:使用要点、性能优化与运维维护
中间件·性能优化·kafka
九英里路3 天前
protobuf快速上手
网络·c++·中间件·json·谷歌·序列化·protobuf
lsc_blog5 天前
听到优化风声,先准备能由自己掌控的事
数据库·分布式·中间件·职场和发展·重构
大草原的小灰灰9 天前
LLM应用的标准开发框架LangChain(八)- 中间件
python·中间件·langchain
真上帝的左手14 天前
30. 技术专题-‌应用框架组件-关系型数据库-MySQL-Mybatis
数据库·分布式·mysql·中间件·mybatis
96245614 天前
容器 RUNNING,为什么中间件仍不可用?ActiveMQ 与 Kafka/ZooKeeper 恢复实录
中间件·kafka·activemq
真上帝的左手14 天前
30. 技术专题-‌应用框架组件-缓存-Redis
数据库·redis·分布式·缓存·中间件
真上帝的左手14 天前
30. 技术专题-‌应用框架组件-搜索引擎-ES
大数据·分布式·elasticsearch·搜索引擎·中间件
kingx315 天前
BugKu PRA 渗透测试 2(Harry‘s Blog):9 Flag 全链实战复盘
中间件·渗透测试·log4j2·内网渗透·反序列化
sun_weitao15 天前
用 FastAPI + MQTT 做一个 ESP32最小化跑通示例
中间件·vue·fastapi