NestJS使用Multipart时触发DTO验证导致Bad Request问题求助

当使用multipart/form-data进行文件上传时，NestJS通过Multer处理请求，此时@Body()解析的是表单字段而非JSON格式。如果你的CreateTicketDto验证规则与表单字段不匹配（比如字段名大小写不一致、必填字段未传递、类型不兼容），或者未正确配置验证管道以支持表单数据解析，就会触发400 Bad Request。

1. 开启详细验证错误信息 #

先配置验证管道，获取具体的错误详情，定位问题：
在main.ts中添加以下配置：

import { ValidationPipe } from '@nestjs/common';

async function bootstrap() {
  const app = await NestFactory.create(AppModule);
  app.useGlobalPipes(new ValidationPipe({
    whitelist: true,
    transform: true,
    disableErrorMessages: false, // 关闭错误信息禁用，显示具体验证失败原因
    validationError: { target: false }, // 可选：隐藏目标对象，只显示错误字段和信息
  }));
  await app.listen(3000);
}
bootstrap();

重新请求后，会得到类似如下的详细错误，能直接看到哪个字段验证失败：

{
  "statusCode": 400,
  "message": ["title must be a string", "description should not be empty"],
  "error": "Bad Request"
}

2. 确保表单字段与DTO属性完全匹配 #

• Postman中form-data的字段名必须和CreateTicketDto的属性名大小写完全一致（比如DTO里是title，就不能写成Title）。
• 检查DTO的验证装饰器是否适配表单输入：比如表单传递的是字符串，DTO就用@IsString()，而不是@IsJSON()；必填字段要加@IsNotEmpty()，确保Postman中已填写该字段。

示例CreateTicketDto：

import { IsNotEmpty, IsString } from 'class-validator';

export class CreateTicketDto {
  @IsString()
  @IsNotEmpty()
  title: string;

  @IsString()
  description: string;
}

3. 正确注入上传的文件 #

不要注释掉@UploadedFile()装饰器，FileInterceptor需要通过它将上传的文件挂载到控制器参数中，否则可能影响Multer对请求的解析流程：

@Post()
@UseInterceptors(FileInterceptor('image', SaveImageToStorage))
create(
  @Body() createTicketDto: CreateTicketDto,
  @UploadedFile() file: Express.Multer.File, // 恢复这个注入
  @Request() req,
) {
  try {
    console.log('上传的文件:', file);
    console.log('表单参数:', createTicketDto);
    // return this.ticketService.create(createTicketDto, file);
  } catch (error) {
    console.log(error);
  }
}

4. 检查Multer配置是否正确 #

确保SaveImageToStorage配置正确，比如存储路径存在、权限正常，避免Multer处理文件时出错导致请求中断：

// 示例SaveImageToStorage配置
import { diskStorage } from 'multer';
import { extname } from 'path';

export const SaveImageToStorage = {
  storage: diskStorage({
    destination: './uploads',
    filename: (req, file, cb) => {
      const uniqueSuffix = Date.now() + '-' + Math.round(Math.random() * 1E9);
      cb(null, file.fieldname + '-' + uniqueSuffix + extname(file.originalname));
    },
  }),
  fileFilter: (req, file, cb) => {
    if (!file.originalname.match(/\.(jpg|jpeg|png|gif)$/)) {
      return cb(new Error('只允许上传图片文件'), false);
    }
    cb(null, true);
  },
};

最常见的问题是表单字段与DTO验证规则不匹配，或者未开启详细错误信息导致无法定位具体问题。先配置验证管道获取详细错误，再逐一排查字段匹配、验证规则、Multer配置即可解决。

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