NestJS中Class Validator验证整数数组参数失败问题排查

问题本质 #

用@IsInt({ each: true })验证整数数组时，即便传入整数仍报错，核心原因是HTTP请求体的参数默认以字符串形式传递，class-validator无法识别字符串格式的数字为整数，且未开启自动类型转换机制。

解决步骤 #

1. 全局配置类型转换验证管道 #

在main.ts中启用ValidationPipe，开启自动转换与隐式类型转换，确保请求数据能匹配DTO定义的类型：

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({
    transform: true, // 启用自动类型转换
    transformOptions: {
      enableImplicitConversion: true, // 允许字符串转数字这类隐式转换
    },
  }));
  await app.listen(3000);
}
bootstrap();

2. 在DTO中添加类型转换装饰器 #

给数组字段加上@Type(() => Number)，明确告知class-transformer将数组内每个元素转为数字类型后，再执行整数验证：

import { IsArray, IsInt } from 'class-validator';
import { ApiProperty } from '@nestjs/swagger';
import { Type } from 'class-transformer';

export class SearchRequest {
  @IsArray()
  @Type(() => Number) // 强制将数组元素转为Number类型
  @IsInt({ each: true })
  @ApiProperty({
    description: '用于搜索的ID列表',
    type: [Number],
    example: [13245, 54321],
  })
  ids: number[];
}

3. 确认请求参数格式 #

通过Swagger或其他工具发请求时，要保证请求体里的数组是数字类型而非字符串类型，示例正确格式：

{
  "ids": [13245, 54321]
}

错误格式（会触发验证失败）：

{
  "ids": ["13245", "54321"]
}

内容的提问来源于stack exchange，提问作者J.Cart