如何在 NestJS 中为不同路由动态传递参数到中间件_技术教程

nestjs 中无法直接为不同路由的中间件实例化时传入独立参数，但可通过自定义拦截器（interceptor）结合路由元数据实现条件化行为控制，从而替代中

间件完成按路由定制逻辑（如 `{x: true, y: false, z: true}`）的目标。

在 NestJS 中，中间件（Middleware）本身不具备路由级参数注入能力——use() 方法注册的中间件是全局或模块级绑定的，无法像守卫（Guard）或拦截器（Interceptor）那样天然访问 ExecutionContext 和路由上下文。因此，试图通过中间件为 /users 和 /posts 分别传入不同配置对象（如 {x:true,y:false,z:true} vs {x:false,y:false,z:true}）本质上违背了中间件的设计定位。

✅ 正确解法：使用 自定义拦截器（Custom Interceptor）
拦截器可访问完整的 ExecutionContext，轻松获取当前请求的控制器、方法及路由路径，并支持通过装饰器注入元数据，实现真正的“每路由差异化逻辑”。

✅ 实现步骤

1. 创建路由元数据装饰器

// decorators/route-config.decorator.ts
import { SetMetadata } from '@nestjs/common';

export const ROUTE_CONFIG = 'routeConfig';

export const RouteConfig = (config: Record) =>
  SetMetadata(ROUTE_CONFIG, config);

2. 创建条件感知拦截器

// interceptors/conditional.interceptor.ts
import {
  Injectable,
  NestInterceptor,
  ExecutionContext,
  CallHandler,
} from '@nestjs/common';
import { Observable, of } from 'rxjs';
import { Reflector } from '@nestjs/core';

@Injectable()
export class ConditionalInterceptor implements NestInterceptor {
  constructor(private readonly reflector: Reflector) {}

  intercept(context: ExecutionContext, next: CallHandler): Observable {
    const request = context.switchToHttp().getRequest();
    const config = this.reflector.getAllAndMerge>(
      'routeConfig',
      [context.getHandler(), context.getClass()],
    );

    // ✅ 此处可基于 config 执行差异化逻辑
    console.log('Route config:', config); // e.g., {x: true, y: false, z: true}

    // 示例：根据 x 控制是否跳过业务逻辑
    if (config?.x === false) {
      return of({ message: 'Skipped by x=false' });
    }

    // 示例：根据 z 决定是否记录日志
    if (config?.z) {
      console.log(`[LOG] ${request.method} ${request.url}`);
    }

    return next.handle();
  }
}

3. 在控制器方法上应用装饰器

// controllers/user.controller.ts
import { Controller, Get, UseInterceptors } from '@nestjs/common';
import { RouteConfig } from '../decorators/route-config.decorator';
import { ConditionalInterceptor } from '../interceptors/conditional.interceptor';

@Controller('users')
export class UserController {
  @Get()
  @RouteConfig({ x: true, y: false, z: true })
  @UseInterceptors(ConditionalInterceptor)
  findAll() {
    return ['user1', 'user2'];
  }
}

// controllers/post.controller.ts
@Controller('posts')
export class PostController {
  @Get()
  @RouteConfig({ x: false, y: false, z: true })
  @UseInterceptors(ConditionalInterceptor)
  findAll() {
    return ['post1', 'post2'];
  }
}