🧼 NestJS Pipes 완벽 가이드 – 유효성 검증과 데이터 변환의 핵심

🧼 NestJS Pipes 완벽 가이드 – 유효성 검증과 데이터 변환의 핵심

---

NestJS에서 **Pipe(파이프)**는 입력 데이터를 가공, 검증, 변환하는 도구입니다.
이 글은 NestJS 공식 문서 Pipes를 기반으로 한글 번역 + 실무 중심 해설로 구성했습니다.

"백엔드의 품질은 입력 검증에서 결정됩니다."
NestJS의 Pipe를 잘 쓰면 DTO + Validation + Type 변환까지 한 번에 해결됩니다!

---

✅ Pipe란?

• 요청(Request)에서 들어온 데이터를 변환(transform) 하거나 검증(validate) 하는 데 사용됩니다.
• NestJS에서는 @Body(), @Param(), @Query() 등에서 자동으로 파이프를 적용할 수 있습니다.
• Express의 middleware와 달리, 데이터 레벨에서 작동하는 전처리기라고 보면 됩니다.

---

1️⃣ 기본 Pipe 구현 예제

import { PipeTransform, Injectable, ArgumentMetadata } from '@nestjs/common';

@Injectable()
export class UppercasePipe implements PipeTransform {
  transform(value: any, metadata: ArgumentMetadata) {
    return typeof value === 'string' ? value.toUpperCase() : value;
  }
}

---

2️⃣ Pipe 사용 방법

반응형

@Get(':name')
getUser(@Param('name', UppercasePipe) name: string) {
  return `사용자 이름: ${name}`;
}

• @Param()에 Pipe를 연결하면 요청 파라미터가 변환된 값으로 들어옵니다.
• 이 예제에서는 GET /users/john → 사용자 이름: JOHN 이 됩니다.

---

📺 광고

이 지점은 실무 파이프 적용 예시가 나오는 구간으로, 애드센스 클릭률이 높은 영역입니다.

<ins class="adsbygoogle"
     style="display:block"
     data-ad-client="ca-pub-XXXXXXX"
     data-ad-slot="YYYYYYY"
     data-ad-format="auto"
     data-full-width-responsive="true"></ins>

---

3️⃣ ValidationPipe – NestJS의 유효성 검증 핵심

class-validator와 class-transformer 패키지를 함께 사용하여 DTO 기반 유효성 검사를 할 수 있습니다.

설치

npm install class-validator class-transformer

---

DTO 예시

import { IsString, IsInt, MinLength } from 'class-validator';

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

  @IsInt()
  age: number;
}

---

Controller에 적용

@Post()
create(@Body(new ValidationPipe()) body: CreateUserDto) {
  return body;
}

• 요청 Body가 DTO 조건에 맞지 않으면 400 에러 반환
• 자동으로 타입 변환도 수행 (transform: true 옵션 시)

---

글로벌 파이프 적용 (전역 유효성 검사)

async function bootstrap() {
  const app = await NestFactory.create(AppModule);
  app.useGlobalPipes(
    new ValidationPipe({
      transform: true,
      whitelist: true, // DTO에 정의된 값만 허용
      forbidNonWhitelisted: true, // 정의되지 않은 필드는 에러 처리
    }),
  );
  await app.listen(3000);
}

실무에서는 global-pipe + DTO + class-validator 조합이 거의 표준입니다.

---

4️⃣ Built-in Pipes (NestJS 기본 제공 파이프들)

Pipe 설명

ParseIntPipe	문자열을 정수로 변환
ParseBoolPipe	문자열을 boolean으로 변환
ParseArrayPipe	문자열을 배열로 변환
DefaultValuePipe	값이 undefined일 경우 기본값 설정
ValidationPipe	DTO 기반 유효성 검증

---

5️⃣ 커스텀 Pipe 실무 예시 – 한국 전화번호 형식 필터

@Injectable()
export class PhoneNumberPipe implements PipeTransform {
  transform(value: string): string {
    if (!/^01[0-9]-\d{3,4}-\d{4}$/.test(value)) {
      throw new BadRequestException('잘못된 전화번호 형식입니다');
    }
    return value;
  }
}

---

🧠 실무 요약 전략

위치 Pipe 적용 설명

@Param()	ParseIntPipe 등으로 경로 매개변수 처리
@Query()	쿼리 문자열의 타입 변환
@Body()	DTO + ValidationPipe → 완전한 입력 검증 시스템
Global	app.useGlobalPipes(...)로 전역 적용

---

🔚 마무리 요약

• Pipe는 NestJS의 강력한 전처리 유효성 검사 도구
• DTO + class-validator로 타입 검증 가능
• 커스텀 Pipe로 유연한 비즈니스 로직 적용
• 글로벌 Pipe 설정을 통한 전역 일관성 유지

---

 

NestJS Pipe,NestJS ValidationPipe,NestJS 유효성검사,NestJS DTO 검증,NestJS class-validator,NestJS 글로벌 파이프,NestJS Pipe 실무 예제,NestJS 타입 변환,NestJS 요청 검증,NestJS 백엔드 보안

---