NestJS多文件上传验证问题：如何批量校验图片文件？

问题核心：ParseFilePipe（包括你继承它的ImageFileValidationPipe）是为单个文件校验设计的，当用在@UploadedFiles装饰器时，它接收的是整个文件对象（{ nic_front: File[], ... }），而非单个文件，因此无法自动遍历并校验每个文件。

解决方案：自定义多文件处理管道 #

我们需要实现一个能遍历多字段文件对象的管道，对每个字段下的每一个文件单独执行校验逻辑。

1. 自定义多文件校验管道

import {
  PipeTransform,
  Injectable,
  BadRequestException,
  FileTypeValidator,
  MaxFileSizeValidator,
} from '@nestjs/common';

@Injectable()
export class MultiImageFileValidationPipe implements PipeTransform {
  private readonly maxSizeValidator = new MaxFileSizeValidator({
    maxSize: 2 * 1024 * 1024, // 2MB
    message: 'File size exceeds the limit of 2MB.',
  });

  private readonly fileTypeValidator = new FileTypeValidator({
    fileType: '^image\\/(jpeg|png)$',
  });

  async transform(files: { [key: string]: Express.Multer.File[] }) {
    // 遍历每个文件字段（nic_front、nic_back等）
    for (const fieldName in files) {
      const fieldFiles = files[fieldName];
      if (!fieldFiles) continue;

      // 校验该字段下的每一个文件
      for (const file of fieldFiles) {
        try {
          await this.maxSizeValidator.validate(file);
          await this.fileTypeValidator.validate(file);
        } catch (error) {
          // 抛出包含字段名的错误，方便定位问题
          throw new BadRequestException(`Field ${fieldName}: ${error.message}`);
        }
      }
    }
    return files;
  }
}

2. 修改控制器代码

将原来的ImageFileValidationPipe替换为新的MultiImageFileValidationPipe：

@Patch('/register')
@UseInterceptors(
  FileFieldsInterceptor([
    { name: 'nic_front', maxCount: 1 },
    { name: 'nic_back', maxCount: 1 },
    { name: 'live_photograph', maxCount: 1 },
  ]),
)
registerAdmin(
  @UploadedFiles(MultiImageFileValidationPipe)
  files: {
    nic_front?: Express.Multer.File[];
    nic_back?: Express.Multer.File[];
    live_photograph?: Express.Multer.File[];
  },
  @Body() data: any,
) {
  // 业务逻辑
}

关键说明 #

• 管道实现了PipeTransform接口，直接处理@UploadedFiles传递的文件对象结构
• 复用了NestJS内置的MaxFileSizeValidator和FileTypeValidator，避免重复造轮子
• 错误信息中包含字段名，前端可以更清晰地提示用户哪个文件不符合要求
• 支持每个字段下多个文件的校验（即使你当前设置maxCount:1，后续扩展多文件上传也无需修改管道）

内容的提问来源于stack exchange，提问作者Dhanuja Thishakya Samaranayake