NestJS：如何通过@Body()装饰器正确获取POST请求体？

嘿，我刚碰到过类似的坑，这大概率是请求内容类型（Content-Type）不匹配或者后端没配置对应的解析器导致的！让我一步步帮你搞定：

核心原因先搞懂 #

NestJS 默认只会自动解析 application/json 格式的请求体。如果你的前端发送的是表单数据（比如 HTML 表单默认的 application/x-www-form-urlencoded，或者带文件的 multipart/form-data），Nest 不会自动处理这些格式，所以 @Body() 就会拿到 undefined。

分场景解决问题 #

场景1：推荐用JSON格式发送数据 #

这是Nest最适配的方式，只需要调整前端请求和后端DTO定义：

1. 前端请求要符合要求：

   • 必须设置请求头 Content-Type: application/json
   • 请求体要转成JSON字符串（比如用 JSON.stringify() 处理数据对象）
     举个fetch的示例：

   fetch('/my-route', {
     method: 'POST',
     headers: { 'Content-Type': 'application/json' },
     body: JSON.stringify({ elementOfInterest: '你的目标数据' })
   })
   

2. 后端代码优化：
   给DTO加上验证装饰器（可选但非常推荐，能确保数据格式正确），同时启用ValidationPipe自动转换请求体到DTO类型：

   // my.dto.ts
   import { IsString } from 'class-validator';
   
   export class MyDto {
     @IsString() // 约束字段为字符串类型
     elementOfInterest: string;
   }
   

   控制器代码更新：

   import { Controller, Post, Body, UsePipes, ValidationPipe } from '@nestjs/common';
   import { MyService } from 'my.service';
   import { MyDto } from './dto/my.dto';
   
   @Controller('my-route')
   export class MyController {
     constructor(private readonly _myService: MyService) {}
   
     @Post()
     @UsePipes(new ValidationPipe({ transform: true })) // 自动转换并验证请求体
     async myMethod(@Body() myDto: MyDto) {
       console.log(myDto); // 现在应该能正确拿到数据了
       return await this._myService.doStuff(myDto.elementOfInterest);
     }
   }
   

场景2：必须发送表单数据（x-www-form-urlencoded） #

如果前端就是要传传统表单数据，那需要在后端启用表单解析器：

1. 在main.ts添加表单解析中间件：

   import { NestFactory } from '@nestjs/core';
   import { AppModule } from './app.module';
   import * as express from 'express';
   
   async function bootstrap() {
     const app = await NestFactory.create(AppModule);
     // 解析application/x-www-form-urlencoded格式的表单数据
     app.use(express.urlencoded({ extended: true }));
     await app.listen(3000);
   }
   bootstrap();
   

2. 控制器代码保持不变，但要确保DTO的字段名和表单的input name完全一致（大小写敏感！），这样@Body()就能正确映射数据。

场景3：带文件的表单数据（multipart/form-data） #

如果表单包含文件上传，需要额外处理：

1. 先安装依赖：

   npm install @nestjs/platform-express multer
   

2. 控制器中使用FileInterceptor处理文件和表单字段：

   import { Controller, Post, Body, UploadedFile, UseInterceptors } from '@nestjs/common';
   import { FileInterceptor } from '@nestjs/platform-express';
   import { MyService } from 'my.service';
   import { MyDto } from './dto/my.dto';
   
   @Controller('my-route')
   export class MyController {
     constructor(private readonly _myService: MyService) {}
   
     @Post()
     @UseInterceptors(FileInterceptor('file')) // 'file'是表单中文件input的name属性值
     async myMethod(@Body() myDto: MyDto, @UploadedFile() file: Express.Multer.File) {
       console.log(myDto); // 表单中的普通字段
       console.log(file); // 上传的文件信息
       return await this._myService.doStuff(myDto.elementOfInterest, file);
     }
   }
   

最后检查小Tips #

• 确认前端发送的请求头Content-Type和后端配置的解析器完全匹配
• 确认DTO的字段名和请求体中的键名完全一致（大小写敏感！）
• 如果启用了ValidationPipe，确保DTO的验证规则符合你的数据要求

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