NestJS开发中@Body装饰器未包含上传File字段的问题咨询

为什么默认@Body拿不到文件？ #

NestJS 处理multipart/form-data请求时，内置的body-parser不会解析二进制文件内容，这部分逻辑由FileInterceptor基于Multer单独处理：文本字段会被挂载到req.body上，文件内容会被单独挂载到req.file上，因此默认的@Body()装饰器只能拿到文本字段，无法包含文件数据。

具体实现方案 #

方案1：单个接口轻量合并（适合当前单文件场景） #

你只需要在控制器中把@UploadedFile()拿到的文件手动赋值到DTO上即可，不需要修改现有存储配置或拦截器逻辑：

@Post()
@UseInterceptors( FileInterceptor( "file", { storage }))
async createNewTask(@UploadedFile() file: Express.Multer.File, @Body() dto: CreateTaskDto) {
  // 手动将文件挂载到DTO属性，实现全字段对齐
  dto.file = file;

  // 后续逻辑直接使用dto即可，已包含title/description/file三个属性
}

同时建议把DTO中file的any类型替换为Multer提供的标准类型，获得完整类型提示：

import { Express } from 'express';

export class CreateTaskDto {
  title: string;
  description: string;
  file: Express.Multer.File;
}

方案2：封装可复用装饰器（适合多接口统一处理） #

如果多个接口都需要这种「文件合并到请求体DTO」的逻辑，可以封装自定义参数装饰器，避免每个控制器重复写合并代码：

1. 新建装饰器文件common/decorators/merged-body-with-file.decorator.ts：

import { createParamDecorator, ExecutionContext } from '@nestjs/common';
import { Request } from 'express';

export const MergedBodyWithFile = createParamDecorator(
  (data: unknown, ctx: ExecutionContext) => {
    const request = ctx.switchToHttp().getRequest<Request>();
    // 合并文本字段和单文件，返回和DTO结构完全匹配的对象
    return {
      ...request.body,
      file: request.file
    };
  },
);

2. 控制器直接使用该装饰器，不需要再单独声明@Body()和@UploadedFile()：

@Post()
@UseInterceptors( FileInterceptor( "file", { storage }))
async createNewTask(@MergedBodyWithFile() dto: CreateTaskDto) {
  // 这里的dto已自动包含所有三个字段，完全符合你的DTO定义
}

扩展说明 #

• 如果是多文件上传场景，只需要把FileInterceptor替换为FilesInterceptor，同时修改装饰器里的request.file为request.files即可。
• 搭配ValidationPipe做DTO校验时，合并后的文件字段会被正常识别，只需要按标准class-validator规则给file字段加校验注解即可。

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