如何在NestJS中使用Class Validator实现复杂DTO验证

1. 移除冗余必填约束 #

原DTO中attachment字段的@IsNotEmpty()需删除，因为需求是至少一个字段必填，而非强制要求附件字段。

2. 实现自定义验证器 #

创建一个验证器，用于检查DTO对象中是否至少有一个字段（title/body/attachment）存在有效值：

import { ValidatorConstraint, ValidatorConstraintInterface, ValidationArguments } from 'class-validator';
import { CreateFeedDto } from './create-feed.dto';

@ValidatorConstraint({ name: 'AtLeastOneFieldRequired', async: false })
export class AtLeastOneFieldRequired implements ValidatorConstraintInterface {
  validate(_: unknown, args: ValidationArguments) {
    const dto = args.object as CreateFeedDto;
    // 校验至少一个字段有有效值
    return !!dto.title || !!dto.body || !!dto.attachment;
  }

  defaultMessage() {
    return '标题、正文和附件不能同时为空';
  }
}

3. 调整CreateFeedDto验证规则 #

修改字段装饰器，并将自定义验证器绑定到title字段（确保所有字段为空时，错误信息显示在该字段上）：

import { IsOptional, Length, IsString, IsInstance, Validate } from 'class-validator';
import { AtLeastOneFieldRequired } from './at-least-one-field-required.validator';

export class CreateFeedDto {
  @IsOptional()
  @IsString({ message: '标题必须为字符串类型' })
  @Length(3, 100, { message: '标题长度需在3-100字符之间' })
  @Validate(AtLeastOneFieldRequired)
  title: string;

  @IsOptional()
  @IsString({ message: '正文必须为字符串类型' })
  @Length(5, 500, { message: '正文长度需在5-500字符之间' })
  body: string;

  @IsOptional()
  @IsInstance(File, { message: '附件必须为File类型' })
  attachment: File;
}

验证逻辑说明 #

• 至少一个字段必填：通过自定义验证器实现，当所有字段为空时，错误信息会显示在title字段上。
• 字段单独校验：每个字段保留原有规则，若提供该字段值，必须符合对应的类型、长度约束。
• 支持多字段共存：所有字段标记@IsOptional()，允许同时提供多个字段的值，只要符合各自规则即可。

内容的提问来源于stack exchange，提问作者Md. A. Apu