如何在NestJS DTO中同时支持string与string[]并实现校验？

在NestJS中使用class-validator实现string | string[]类型的校验，核心是用条件校验装饰器针对不同类型分别应用校验规则，而非单一的@IsString()。

直接上可运行的代码示例：

import { IsOptional, IsString, IsArray, ValidateIf } from 'class-validator';
import { SomeBaseRequestDto } from './your-base-dto-path';

export class MyRequestDto extends SomeBaseRequestDto {
  @IsOptional()
  // 当值为字符串时，校验是否为合法字符串
  @ValidateIf((_, value) => typeof value === 'string')
  @IsString()
  // 当值为数组时，校验是否为全字符串数组
  @ValidateIf((_, value) => Array.isArray(value))
  @IsArray()
  @IsString({ each: true })
  // 可选要求：如果需要数组至少包含一个元素，添加下面一行
  // @MinLength(1)
  key?: string | string[];
}

逻辑说明 #

• 原有的@IsString()会直接拒绝数组类型参数，这是多值请求报错的核心原因；
• @ValidateIf会根据当前值的类型，选择性触发后续校验规则：
  • 当key是单个字符串时，仅执行@IsString()校验；
  • 当key是多值数组时，执行@IsArray()和@IsString({ each: true })（确保数组内每个元素都是字符串）；
• 保留@IsOptional()，符合你原本的“可选参数”需求。

额外补充 #

如果项目启用了class-transformer自动转换（NestJS默认开启），这种写法会和TS类型声明string | string[]完美配合，既完成了运行时校验，又保留了静态类型提示。

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