如何解决NestJS class-validator校验失效问题？

问题原因 #

当POST请求传入数字类型的loginId时，NestJS默认的ValidationPipe会配合class-transformer自动将数字转换为字符串类型，导致@IsString()校验规则被绕过——因为转换后的值确实是字符串格式的数字，符合校验要求。

解决方案 #

1. 禁用自动隐式类型转换 #

在main.ts中调整ValidationPipe的配置，关闭自动类型转换，确保传入值的原始类型被校验：

async function bootstrap() {
  const app = await NestFactory.create(AppModule);
  app.useGlobalPipes(new ValidationPipe({
    transform: true,
    transformOptions: {
      enableImplicitConversion: false, // 禁用自动类型转换
    },
  }));
  await app.listen(3000);
}
bootstrap();

2. 给字段添加更严格的校验规则 #

如果需要确保loginId是纯字符串（而非数字转成的字符串），可以结合正则校验：

import { IsString, Matches } from 'class-validator';

export class LoginUserDto {
  @IsString()
  @Matches(/^[^\d]+$/, { message: 'loginId不能包含数字或纯数字格式' })
  loginId: string;

  @IsString()
  password: string;
}

3. 自定义转换逻辑拦截数字输入 #

使用@Transform装饰器手动校验输入类型，拦截数字格式的loginId：

import { IsString } from 'class-validator';
import { Transform } from 'class-transformer';

export class LoginUserDto {
  @Transform(({ value }) => {
    if (typeof value === 'number') {
      throw new Error('loginId不允许为数字类型');
    }
    return value;
  })
  @IsString()
  loginId: string;

  @IsString()
  password: string;
}

验证效果 #

修改配置或DTO后，再发送含数字类型loginId的POST请求，会触发校验失败并返回对应错误响应。

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