如何用NestJS默认的class-validator验证对象至少一个必填字段？

完全可以用class-validator实现这种多字段组合验证，不需要替换为其他库，只需通过自定义验证器将验证逻辑从控制器抽离，让代码更清晰。以下是具体实现方案：

方案1：针对特定Dto的自定义验证器 #

1. 创建自定义验证类 #

实现ValidatorConstraintInterface接口，编写对象级验证逻辑：

import { ValidatorConstraint, ValidatorConstraintInterface, ValidationArguments } from 'class-validator';

@ValidatorConstraint({ name: 'messageAtLeastOneField', async: false })
export class MessageAtLeastOneFieldValidator implements ValidatorConstraintInterface {
  validate(dto: any, args: ValidationArguments) {
    // 验证附件ID数组非空，或文本内容非空（去除首尾空格后）
    return (dto.attachmentIds?.length > 0) || (dto.text?.trim().length > 0);
  }

  defaultMessage(args: ValidationArguments) {
    return '消息必须包含附件ID或文本内容，至少一项不能为空';
  }
}

2. 在Dto上绑定验证器 #

直接在MessageDto类上使用@Validate装饰器，指定自定义验证器：

import { Validate } from 'class-validator';
import { MessageAtLeastOneFieldValidator } from './message-at-least-one.validator';

@Validate(MessageAtLeastOneFieldValidator)
export class MessageDto {
  attachmentIds?: string[];
  text?: string;
}

方案2：通用型自定义装饰器（推荐） #

如果需要在多个Dto中复用“至少一个字段非空”的验证逻辑，可以封装成通用装饰器：

1. 创建通用验证类与装饰器 #

import { ValidatorConstraint, ValidatorConstraintInterface, ValidationArguments, registerDecorator, ValidationOptions } from 'class-validator';

@ValidatorConstraint({ name: 'atLeastOneNotEmpty', async: false })
export class AtLeastOneNotEmptyValidator implements ValidatorConstraintInterface {
  validate(dto: any, args: ValidationArguments) {
    const [targetFields] = args.constraints;
    // 遍历指定字段，判断是否至少有一个字段满足非空条件
    return targetFields.some(field => {
      const value = dto[field];
      if (Array.isArray(value)) return value.length > 0;
      if (typeof value === 'string') return value.trim().length > 0;
      return !!value;
    });
  }

  defaultMessage(args: ValidationArguments) {
    const [targetFields] = args.constraints;
    return `必须至少填写以下字段中的一项：${targetFields.join(', ')}`;
  }
}

// 封装成装饰器，方便直接调用
export function AtLeastOneNotEmpty(fields: string[], validationOptions?: ValidationOptions) {
  return function (target: any) {
    registerDecorator({
      target: target,
      constraints: [fields],
      options: validationOptions,
      validator: AtLeastOneNotEmptyValidator,
    });
  };
}

2. 在Dto中使用通用装饰器 #

import { AtLeastOneNotEmpty } from './at-least-one-not-empty.decorator';

@AtLeastOneNotEmpty(['attachmentIds', 'text'], { 
  message: '消息必须包含附件ID或文本内容，至少一项不能为空' 
})
export class MessageDto {
  attachmentIds?: string[];
  text?: string;
}

启用验证管道 #

确保在NestJS全局启用ValidationPipe，让验证自动生效：

// main.ts
import { NestFactory } from '@nestjs/core';
import { AppModule } from './app.module';
import { ValidationPipe } from '@nestjs/common';

async function bootstrap() {
  const app = await NestFactory.create(AppModule);
  app.useGlobalPipes(new ValidationPipe({
    whitelist: true,
    transform: true,
    forbidNonWhitelisted: true,
  }));
  await app.listen(3000);
}
bootstrap();

这样配置后，请求到达控制器前会自动完成验证，验证不通过时会返回400错误及自定义提示信息，控制器无需再手动编写验证逻辑，代码结构更清晰。

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