Nest.js：带可选文件的Form Data请求如何同时获取Body并验证

问题核心 #

处理包含可选文件的Form Data请求时，默认FileInterceptor仅处理文件字段，无法解析其他表单字段；同时需对表单字段做合法性校验，且允许请求不携带文件。

解决方案 #

1. 配置可选文件处理 #

在ParseFilePipe中设置fileIsRequired: false，确保无文件时请求不报错。

2. 解析并验证表单字段 #

直接用@Body()装饰器获取非文件字段，同时传入自定义校验管道完成合法性验证。

修改后的完整代码 #

import {
  Body,
  Controller,
  MaxFileSizeValidator,
  ParseFilePipe,
  Post,
  UploadedFile,
  UseInterceptors,
  Optional,
} from "@nestjs/common";
import { JoiValidationPipe } from "../../pipes/validation/joi-validation.pipe";
import { UserValidatorSchema } from "./validator/account-register.validator";
import { CreateUserDto } from "./dtos/account-register.dto";
import { AccountRegisterService } from "./account-register.service";
import { FileInterceptor } from "@nestjs/platform-express";
import { MAX_FILE_SIZE } from "../../constants/multer.constants";

@Controller("user")
export class FormdataWithFileController {
  constructor(private readonly _formdataWithFileService: AccountRegisterService) {}

  @Post("formdataWithFile")
  @UseInterceptors(FileInterceptor("file"))
  async Signup(
    @Body(new JoiValidationPipe(UserValidatorSchema)) createUserDto: CreateUserDto,
    @Optional()
    @UploadedFile(
      new ParseFilePipe({
        validators: [new MaxFileSizeValidator({ maxSize: MAX_FILE_SIZE })],
        fileIsRequired: false // 允许请求不携带文件
      })
    )
    file?: Express.Multer.File,
  ) {
    return await this._formdataWithFileService.execute(createUserDto, file);
  }
}

关键说明 #

• @Optional() + fileIsRequired: false：确保无文件时file参数为undefined，避免触发错误。
• @Body(new JoiValidationPipe(UserValidatorSchema))：直接对Form Data中的非文件字段执行Joi校验，复用已有校验规则。
• file?: Express.Multer.File：用可选类型标注文件参数，符合TypeScript类型规范。
• 服务层适配：需调整AccountRegisterService的execute方法，接收createUserDto和可选file参数处理业务逻辑。

额外注意 #

• multer默认配置即可满足基础需求，若需自定义存储路径或文件名，可在FileInterceptor第二个参数中传入multer配置（如{ dest: './uploads' }）。
• 若用class-validator替代Joi，只需将JoiValidationPipe替换为ValidationPipe，并在CreateUserDto中添加对应验证装饰器。

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