Nest.js使用class-validator自定义图片上传验证器不执行问题

• TypeScript的类型标注仅在编译阶段生效，运行时会完全擦除，你写的image: UploadImageDto不会让Nest自动把上传的文件对象转为Dto实例，也不会自动触发校验逻辑。
• 自定义校验器IsImageFile没有在对应业务模块的providers数组中注册，Nest无法识别加载该自定义约束，自然不会执行校验逻辑。
• @UploadedFile()注入的是multer解析生成的普通JS对象，默认不会被ValidationPipe拦截校验，常规ValidationPipe默认仅处理@Body()/@Query()/@Param()这类请求参数。
• 未对@UploadedFile()参数显式绑定ValidationPipe，校验规则没有触发入口。

可根据需求二选一：

方案1：修复现有class-validator校验逻辑 #

1. 先在使用自定义校验器的模块中注册该验证器，示例代码：

// upload.module.ts
import { Module } from '@nestjs/common';
import { IsImageFile } from './validators/IsImageFile';
import { UploadController } from './upload.controller';

@Module({
  controllers: [UploadController],
  providers: [IsImageFile], // 必须注册自定义验证器
})
export class UploadModule {}

2. 给@UploadedFile()参数显式绑定开启了自动转换的ValidationPipe，修改接口代码：

import {
  Post,
  UseInterceptors,
  FileInterceptor,
  UploadedFile,
  ValidationPipe,
} from '@nestjs/common';
import { UploadImageDto } from './dto/UploadImageDto';

@UseInterceptors(FileInterceptor('image'))
@Post('upload_profile_photo')
async uploadProfilePhoto(
  @UploadedFile(new ValidationPipe({ transform: true }))
  image: UploadImageDto,
) {
  return image;
}

3. 可选优化：如果开了全局ValidationPipe且开启了whitelist: true配置，需要给Dto中不需要校验的文件字段加@Allow()装饰器，避免字段被自动过滤：

import { Validate, Allow } from 'class-validator';
import { IsImageFile } from '../validators/IsImageFile';

export class UploadImageDto {
  @Validate(IsImageFile)
  mimetype: string;

  @Allow()
  originalname: string;

  @Allow()
  size: number;

  @Allow()
  buffer: Buffer;
}

方案2：直接在文件拦截器层做校验（更推荐） #

不需要写Dto和自定义验证器，直接利用multer自带的fileFilter配置在文件解析阶段就完成校验，性能更好、代码更简洁：

import { Post, UseInterceptors, FileInterceptor, UploadedFile, BadRequestException } from '@nestjs/common';

@UseInterceptors(
  FileInterceptor('image', {
    fileFilter: (req, file, callback) => {
      const acceptMimeTypes = ['image/png', 'image/jpeg'];
      if (!acceptMimeTypes.includes(file.mimetype)) {
        // 校验不通过直接返回400错误
        return callback(new BadRequestException('The file type was not accepted.'), false);
      }
      callback(null, true);
    },
    // 可同时配置文件大小限制，避免超大文件上传
    limits: {
      fileSize: 2 * 1024 * 1024, // 限制单文件最大2MB
    },
  }),
)
@Post('upload_profile_photo')
async uploadProfilePhoto(@UploadedFile() image: Express.Multer.File) {
  return image;
}

注意：不要信任前端传的MIME类型，生产环境建议额外增加文件头校验，避免恶意修改后缀名绕过校验。

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