Как настроить валидацию с class-validator в NestJS?

Настройка валидации с class-validator в NestJS

Установка зависимостей

Для работы валидации необходимо установить два пакета:

npm install class-validator class-transformer

class-validator предоставляет декораторы для описания правил валидации, а class-transformer — преобразует plain-объекты запроса в экземпляры DTO-классов, без чего декораторы не работают.

Подключение ValidationPipe

Globalный пайп подключается в main.ts через app.useGlobalPipes():

// main.ts
const app = await NestFactory.create(AppModule);
app.useGlobalPipes(
  new ValidationPipe({
    whitelist: true,        // удаляет поля, не описанные в DTO
    forbidNonWhitelisted: true, // выбрасывает ошибку при лишних полях
    transform: true,        // преобразует входные данные к типам DTO
  }),
);

Опция transform: true критична — без неё class-transformer не создаёт экземпляр класса и декораторы class-validator не срабатывают.

Создание DTO с декораторами

// create-user.dto.ts
import { IsString, IsEmail, IsInt, Min, Max, IsOptional } from 'class-validator';

export class CreateUserDto {
  @IsString()
  name: string;

  @IsEmail()
  email: string;

  @IsInt()
  @Min(18)
  @Max(120)
  age: number;

  @IsOptional()
  @IsString()
  bio?: string;
}

Использование DTO в контроллере

@Post('users')
createUser(@Body() dto: CreateUserDto) {
  // если валидация не прошла — NestJS автоматически вернёт 400 Bad Request
  return this.usersService.create(dto);
}

Вложенная валидация

Для объектов внутри DTO нужен дополнительный декоратор @ValidateNested и @Type:

import { ValidateNested } from 'class-validator';
import { Type } from 'class-transformer';

export class CreateOrderDto {
  @ValidateNested()
  @Type(() => AddressDto)  // указываем класс для трансформации
  address: AddressDto;
}

Кастомные сообщения об ошибках

@IsString({ message: 'Имя должно быть строкой' })
@MinLength(2, { message: 'Имя не может быть короче $constraint1 символов' })
name: string;

Альтернатива: pipe на уровне маршрута

Если глобальный пайп не подходит, его можно применить точечно:

@Post()
createUser(
  @Body(new ValidationPipe()) dto: CreateUserDto
) { ... }

Частые проблемы

• Без transform: true валидация не работает, потому что NestJS передаёт plain object, а не экземпляр класса.
• Без @Type(() => NestedDto) вложенные объекты не трансформируются и @ValidateNested игнорируется.