NestJS结合FileInterceptor时，如何用ValidationPipe将JSON转为对象？

我在使用NestJS实现文件上传功能时，通过@Body('body') createFileDto: CreateFileDto绑定请求体，但全局配置的ValidationPipe无法正常处理，抛出错误：an unknown value was passed to the validate function.

相关代码片段 #

原控制器代码 #

@Controller('files')
export class FilesController {
  constructor(private readonly filesService: FilesService) {}

  @Post()
  @UseInterceptors(FileInterceptor('file'))
  uploadFileToServer(
    @UploadedFile() file: Express.Multer.File,
    @Body('body') createFileDto: CreateFileDto,
    @ActiveUser() user: ActiveUserType,
  ) {
    console.log(createFileDto);
    return this.filesService.create(createFileDto, file, user);
  }
}

全局ValidationPipe配置 #

async function bootstrap() {
  const app = await NestFactory.create(AppModule, {
    bufferLogs: true,
  });
  app.useLogger(app.select(LoggerModule).get(CustomLogger));
  const configService = app.get(ConfigService);
  app.useGlobalPipes(
    new ValidationPipe({
      whitelist: true,
      enableDebugMessages: true,
      // forbidUnknownValues: false,
    }),
  );
  app.listen(configService.get<number>('appPort'), () => {
    const logger = new Logger('Bootstrap');
    logger.log(
      `${configService.get<string>(
        'appName',
      )} service is running on port:${configService.get<number>('appPort')}`,
    );
  });
}

CreateFileDto 定义 #

export class CreateFileDto {
  fileName?: string;

  expirationTime?: number;
}

自定义Pipe尝试（临时方案） #

我曾尝试用自定义Pipe处理，代码如下：

JsonParsePipe

@Injectable()
export class JsonParsePipe implements PipeTransform {
  transform(value: any) {
    try {
      const obj = JSON.parse(value);
      return obj;
    } catch (err) {
      throw new BadRequestException(err.message);
    }
  }
}

TransformPipe

@Injectable()
export class TransformPipe implements PipeTransform {
  constructor(private logger: CustomLogger) {}
  transform(obj: any, metadata: ArgumentMetadata) {
    let tarnsFormObj: any = undefined;
    if (this.isConstructor(metadata.metatype)) {
      tarnsFormObj = new metadata.metatype();
      for (const key in obj) {
        if (Object.prototype.hasOwnProperty.call(obj, key)) {
          tarnsFormObj[key] = obj[key];
        }
      }
    } else {
      this.logger.warn(`TransformPipe not transform the object`, TransformPipe.name, obj);
    }
    return tarnsFormObj ?? obj;
  }
  private isConstructor(f: any): f is Constructor {
    try {
      Reflect.construct(String, [], f);
    } catch (e) {
      return false;
    }
    return true;
  }
}

修改后的控制器接口：

@Post()
@UseInterceptors(FileInterceptor('file'))
uploadFileToServer(
  @UploadedFile() file: Express.Multer.File,
  @Body('body', JsonParsePipe, TransformPipe) _createFileDto: CreateFileDto,
  @ActiveUser() user: ActiveUserType,
) {
  return this.filesService.create(_createFileDto, file, user);
}

现在需要解决的问题：如何正确使用ValidationPipe结合FileInterceptor上传文件时，将请求体中的JSON转换为指定DTO对象？

问题原因 #

使用FileInterceptor时，请求Content-Type为multipart/form-data，NestJS默认不会自动解析body字段中的JSON字符串，直接传递原始字符串给ValidationPipe。而ValidationPipe期望接收可验证的对象，而非字符串，因此抛出错误。

正确解决方案 #

方案1：优化全局ValidationPipe配置+轻量JSON解析Pipe #

1. 调整全局ValidationPipe配置

开启自动转换功能，让ValidationPipe能将解析后的对象转为DTO实例：

app.useGlobalPipes(
  new ValidationPipe({
    whitelist: true,
    enableDebugMessages: true,
    transform: true, // 自动转换原始值为DTO实例
    transformOptions: {
      enableImplicitConversion: true, // 支持隐式类型转换（如字符串转数字）
    },
    // forbidUnknownValues: false, // 若允许请求体含未知字段，可开启此项
  }),
);

2. 简化JSON解析Pipe

@Injectable()
export class ParseJsonPipe implements PipeTransform {
  transform(value: string) {
    if (typeof value !== 'string') return value;
    try {
      return JSON.parse(value);
    } catch (e) {
      throw new BadRequestException('body字段格式无效，请传入合法JSON');
    }
  }
}

3. 修改控制器参数

先解析JSON字符串为对象，再由全局ValidationPipe处理验证和转换：

@Post()
@UseInterceptors(FileInterceptor('file'))
uploadFileToServer(
  @UploadedFile() file: Express.Multer.File,
  @Body('body', ParseJsonPipe) createFileDto: CreateFileDto,
  @ActiveUser() user: ActiveUserType,
) {
  return this.filesService.create(createFileDto, file, user);
}

方案2：拆分form-data字段（推荐） #

如果前端可以将fileName和expirationTime作为独立的form-data字段传递，而非打包到body字段中，可直接绑定整个DTO，无需额外Pipe：

@Post()
@UseInterceptors(FileInterceptor('file'))
uploadFileToServer(
  @UploadedFile() file: Express.Multer.File,
  @Body() createFileDto: CreateFileDto, // 直接绑定，ValidationPipe自动处理验证与转换
  @ActiveUser() user: ActiveUserType,
) {
  return this.filesService.create(createFileDto, file, user);
}

以上两种方案均可让ValidationPipe像处理普通JSON接口一样，完成DTO的验证与转换。

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