NestJS自定义RequestGuard添加all()方法后控制器调用报错

核心问题在于：你定义的自定义Request接口只是编译时类型声明，运行时的Express请求对象并没有实际挂载all()方法。Guard中能正常调用大概率是用了类型断言绕过了类型检查，或者Guard执行时请求对象已被处理，但控制器中的请求对象还是原始的Express实例，导致调用all()时触发undefined错误。

以下是完整的修复步骤：

1. 全局扩展Express Request类型 #

不要新建独立的继承接口，直接扩展Express原生的Request类型，确保所有地方的请求对象类型都能识别all()方法。

在项目根目录创建src/types/express.d.ts类型声明文件：

declare namespace Express {
  interface Request {
    all(): Record<string, any>;
  }
}

修改tsconfig.json确保类型文件被正确识别：

{
  "compilerOptions": {
    "typeRoots": ["./node_modules/@types", "./src/types"]
  }
}

2. 实现全局中间件挂载all()方法 #

类型定义只是编译时提示，必须给每个请求对象添加all()的实际实现。创建全局中间件：

// src/middlewares/request-all.middleware.ts
import { Injectable, NestMiddleware } from '@nestjs/common';
import { Request, Response, NextFunction } from 'express';

@Injectable()
export class RequestAllMiddleware implements NestMiddleware {
  use(req: Request, res: Response, next: NextFunction) {
    // 挂载all方法，整合params、query、body
    req.all = function () {
      return {
        ...req.params,
        ...req.query,
        ...req.body,
      };
    };
    next();
  }
}

在AppModule中全局注册该中间件，确保所有路由都能生效：

// src/app.module.ts
import { Module, NestModule, MiddlewareConsumer } from '@nestjs/common';
import { RequestAllMiddleware } from './middlewares/request-all.middleware';

@Module({
  // 你的其他模块、服务导入
})
export class AppModule implements NestModule {
  configure(consumer: MiddlewareConsumer) {
    consumer.apply(RequestAllMiddleware).forRoutes('*');
  }
}

3. 控制器中正确使用@Req注入 #

现在直接用Express原生的Request类型注入（已被扩展），即可正常调用all()：

// src/customers/customers.controller.ts
import { Controller, Get, Req } from '@nestjs/common';
import { Request } from 'express';

@Controller('customers')
export class CustomersController {
  @Get('order-data/:id')
  getOrderData(@Req() req: Request) {
    return req.all(); // 访问localhost:3000/customers/order-data/1会返回{ id: '1' }
  }
}

验证操作 #

1. 重启NestJS服务，确保类型和中间件加载完成
2. 访问目标路由，此时应返回预期的{ "id": "1" }

内容的提问来源于stack exchange，提问作者user