NestJS에서 DTO란 무엇인가요?

Question

Accepted Answer

**DTO(Data Transfer Object)**는 API로 주고받는 **데이터의 형태**를 정의하는 클래스입니다 — 일반적으로 요청 본문의 구조입니다. DTO는 타입 안전성을 제공하고, 엔드포인트의 명확한 계약 역할을 하며, (검증 decorator와 함께) 자동 입력 검증을 가능하게 합니다.

## DTO 정의하기

```ts
import { IsEmail, IsString, MinLength, IsOptional, IsInt, Min } from "class-validator";

export class CreateUserDto {
  @IsEmail()                    // 유효한 이메일이어야 함
  email: string;

@IsString()
  @MinLength(8)                 // 비밀번호 최소 8자
  password: string;

@IsOptional()                 // 선택적 필드
  @IsInt()
  @Min(0)
  age?: number;
}
```

DTO는 예상되는 데이터를 설명하는 일반 클래스이며, **검증 decorator**(`class-validator` 제공)가 각 필드가 만족해야 하는 규칙을 지정합니다.

## controller에서 DTO 사용하기

```ts
@Post()
create(@Body() dto: CreateUserDto) {     // 본문이 CreateUserDto로 타입 지정 및 검증됨
  // (검증 pipe 활성화 시) 여기서 dto는 유효함이 보장됨
  return this.usersService.create(dto);
}
```

`@Body() dto: CreateUserDto`는 요청 본문의 타입을 지정하고 — 검증 pipe가 활성화되면 — 핸들러가 실행되기 전에 자동으로 검증합니다.

## 자동 검증 활성화

```ts
// main.ts — 전역 검증 pipe 켜기
app.useGlobalPipes(new ValidationPipe({
  whitelist: true,              // DTO에 없는 속성 제거 (보안)
  forbidNonWhitelisted: true,   // 알 수 없는 추가 속성이 있는 요청 거부
  transform: true,              // 페이로드를 DTO 인스턴스로 자동 변환 + 타입 변환
}));
```

`ValidationPipe`를 사용하면 NestJS가 들어오는 본문을 DTO의 decorator에 따라 자동으로 검증합니다 — 검증 실패 시 코드가 실행되기 전에 세부 정보가 담긴 400 오류를 반환합니다.

## DTO 대 Entity

```text
DTO    → API 경계를 넘나드는 데이터의 형태 (요청/응답 계약)
Entity → 데이터베이스 모델 (예: TypeORM entity / Prisma model)
→ 분리하세요: API 계약은 DB 스키마와 결합되어서는 안 됩니다.
  (CreateUserDto는 password+email을 가지고, User entity는 id, timestamp 등을 가짐)
```

DTO는 데이터베이스 entity와 의도적으로 다릅니다 — DTO는 API가 받아들이고/반환하는 것을 나타내며 내부 저장소와 분리됩니다.

## 변형과 재사용

```ts
import { PartialType } from "@nestjs/mapped-types";
// 모든 필드가 선택적인 UpdateUserDto 파생 — 중복 없음
export class UpdateUserDto extends PartialType(CreateUserDto) {}
```

## 왜 중요한가

DTO는 엔드포인트에 타입 안전성, 명확한 API 계약, 자동 검증을 가져오는 중요한 NestJS 패턴입니다.

DTO는 엔드포인트가 받아들이는 데이터(요청 형태)를 정확히 정의하여 컴파일 타임 타입 지정을 제공하고 자기 문서화 계약 역할을 합니다.

결정적으로, `class-validator` decorator 및 `ValidationPipe`와 결합하면 **자동 입력 검증**을 가능하게 합니다 — 형식이 잘못되었거나 악의적인 요청이 비즈니스 로직에 도달하기 *전에* 명확한 오류로 거부되며, 이는 보안과 견고성에 필수적입니다(`whitelist` 옵션도 예상치 못한 속성을 제거합니다).

DTO, 검증 규칙 추가 방법, 검증 pipe 활성화 방법, 그리고 **DTO를 데이터베이스 entity와 분리하는** 중요한 원칙(API 계약을 내부 저장소와 분리)을 이해하는 것은 안전하고 잘 구조화되며 유지보수 가능한 NestJS API를 구축하는 데 기본적입니다.

DTO는 입력을 받는 거의 모든 엔드포인트에 나타나므로 일상적이고 필수적인 지식입니다.