GraphQL vs REST API : 2025년 기준으로 다시 생각해보기

> Node.js 생태계는 자유롭습니다. Express.js로 시작하면 폴더 구조부터 에러 처리까지 모든 것을 개발자가 직접 정해야 하죠.<br>하지만 팀 규모가 커지면 이 "자유"는 곧 "파편화"라는 독이 됩니다. A 개발자와 B 개발자의 코드 스타일이 너무 달라서 협업이 힘들어지는 것이죠.<br>이 문제를 해결하기 위해 등장한, **"Node.js 진영의 Spring Boot"**라 불리는 **NestJS**에 대해 아주 깊이 있게(Deep Dive) 알아봅니다.

![NestJS Logo](https://nestjs.com/img/nest-og.png)

# 1. NestJS란 무엇인가?

NestJS는 **TypeScript**를 기본으로 지원하는 **서버 사이드 프레임워크**입니다. 내부적으로는 Express(기본값)나 Fastify를 래핑해서 동작하지만, 개발자에게는 완전히 다른 경험을 제공합니다.

### 💡 왜 만들어졌을까?
NestJS의 창시자 **Kamil Myśliwiec**은 Angular(프론트엔드 프레임워크)의 아키텍처에서 큰 영감을 받았습니다. Angular처럼 **모듈화(Modularity)**, **의존성 주입(DI)**, **데코레이터(Decorator)** 패턴을 서버 사이드에 도입하여, 대규모 애플리케이션에서도 유지보수가 쉬운 구조를 만들고자 했습니다.

# 2. 핵심 철학 및 아키텍처 (The Core)

NestJS를 지탱하는 3가지 핵심 기둥이 있습니다. 이 구조를 이해하면 NestJS의 80%를 이해한 것입니다.

### ✅ 모듈 (Modules)
애플리케이션을 기능 단위로 나누는 가장 큰 덩어리입니다. `@Module` 데코레이터를 사용하며, 관련된 컨트롤러와 서비스를 묶어 캡슐화합니다.

```typescript
// user.module.ts
@Module({
  imports: [TypeOrmModule.forFeature([User])], // 다른 모듈 가져오기
  controllers: [UserController],               // 이 모듈의 컨트롤러
  providers: [UserService],                    // 이 모듈의 서비스 (비즈니스 로직)
  exports: [UserService],                      // 다른 모듈에서 쓸 수 있게 공개
})
export class UserModule {}
```
모든 NestJS 앱은 적어도 하나의 `AppModule`(루트 모듈)을 가집니다. 마치 레고 블록처럼 모듈을 조립해서 서버를 완성합니다.

### ✅ 컨트롤러 (Controllers)
들어오는 요청(Request)을 받고 응답(Response)을 반환하는 역할을 합니다. `@Controller`, `@Get`, `@Post` 같은 데코레이터를 사용하여 라우팅을 정의합니다.

```typescript
// user.controller.ts
@Controller(users)
export class UserController {
  constructor(private readonly userService: UserService) {} // DI (의존성 주입)

  @Get(:id)
  findOne(@Param(id) id: string) {
    return this.userService.findOne(id);
  }
}
```

### ✅ 프로바이더 (Providers) & DI
비즈니스 로직, DB 접근 등 실제 "일"을 하는 친구들입니다. NestJS의 핵심인 **의존성 주입(Dependency Injection)** 시스템을 통해 관리됩니다.

*   **IoC (제어의 역전)**: 개발자가 직접 `new UserService()`를 하지 않습니다. NestJS 런타임(IoC 컨테이너)이 알아서 객체를 만들고, 필요한 곳(Controller)에 꽂아줍니다.
*   이 덕분에 테스트 코드 작성 시 Mock 객체로 갈아끼우기가 매우 쉬워집니다.

# 3. NestJS만의 강력한 기능들

Express에서는 직접 구현해야 했던 고급 기능들이 NestJS에는 기본 내장되어 있습니다.

### 🛡 파이프 (Pipes) - 유효성 검사
요청 데이터가 올바른지 검사(Validation)하거나 변환(Transformation)합니다. `class-validator` 라이브러리와 함께 쓰면 DTO(Data Transfer Object)만 정의해도 자동으로 검사가 끝납니다.

```typescript
@Post()
create(@Body(ValidationPipe) createUserDto: CreateUserDto) {
  // createUserDto는 이미 검증이 끝난 안전한 데이터!
  return this.userService.create(createUserDto);
}
```

### 🛡 가드 (Guards) - 인증/인가
요청을 처리하기 전에 "이 사용자가 권한이 있는가?"를 검사합니다. JWT 토큰 검사 등을 여기서 처리하면 비즈니스 로직이 깔끔해집니다.

### 🛡 인터셉터 (Interceptors)
요청 전/후에 로직을 끼워넣습니다. 응답 데이터를 가공하거나(직렬화), 실행 시간을 로깅하는 데 쓰입니다. (AOP와 유사)

# 4. 실무 활용: 현재 어디에 쓰이는가?

2025년 현재, NestJS는 단순한 웹 서버를 넘어 다양한 영역에서 표준처럼 쓰이고 있습니다.

### 🏢 엔터프라이즈 백엔드
대한민국은 아무래도 스프링 공화국이어서 여러 예외들이 있지만 해외의 경우에는 스타트업뿐만 아니라 대기업에서도 Node.js로 마이그레이션할 때 NestJS를 1순위로 고려합니다. 유지보수성과 확장성 때문입니다. Spring을 쓰던 인력들이 Node.js로 넘어올 때 가장 이질감이 적은 선택지이기도 합니다.

### 🔗 마이크로서비스 (MSA)
NestJS는 기본적으로 모놀리스뿐만 아니라 MSA를 강력하게 지원합니다. `@nestjs/microservices` 패키지를 통해 RabbitMQ, Kafka, gRPC, Redis Pub/Sub 등을 손쉽게 연동할 수 있습니다. 코드 몇 줄만 바꾸면 HTTP 서버가 gRPC 서버로 변신합니다.

### 🛠 BFF (Backend For Frontend)
프론트엔드(Next.js, React)와 밀접하게 일하는 팀에서, API를 집계하고 가공하는 중간 계층 서버로 NestJS를 많이 사용합니다. TypeScript를 공유할 수 있다는 장점 덕분에 풀스택 개발 생산성이 매우 높습니다.

# 마치며: NestJS를 배워야 할까요?

**되도록 배우는것을 권장 드립니다.**
백엔드 개발자라면 AI 시대에는 Spring, Spring Boot 만으로는 부족합니다. 채용 공고를 봐도 "NestJS 경험 우대"가 많아지고 있습니다.

Express의 자유로움에 지쳐 "정해진 정답"을 찾고 계셨다면, 혹은 Spring Boot처럼 견고한 아키텍처를 Node.js에서도 누리고 싶다면, NestJS가 최고의 선택이 될 것입니다. 지금 바로 `npm i -g @nestjs/cli`를 입력해 보세요! 🚀

Node.js의 Spring Boot? NestJS 완벽 해부 (기본 골자부터 실무 활용까지)

댓글 0

ts-jest 설치 안되는 현상

GraphQL vs REST API : 2025년 기준으로 다시 생각해보기