NestJS 성능은 어떻게 최적화하나요?

Question

Accepted Answer

NestJS 성능 최적화는 **HTTP 어댑터 선택**(Express 대 Fastify), 데이터베이스 효율성, 캐싱, 그리고 일반적인 Node.js 실무에 걸쳐 있습니다. 언제나 그렇듯: **실제 병목을 찾기 위해 프로파일링하세요** — 보통 NestJS 자체가 아니라 데이터베이스나 I/O입니다.

## 더 높은 처리량을 위해 Fastify로 전환

```ts
// NestJS는 기본 Express 어댑터의 대안으로 Fastify를 지원
import { FastifyAdapter } from "@nestjs/platform-fastify";

const app = await NestFactory.create(AppModule, new FastifyAdapter());
// Fastify는 동일한 NestJS 코드로 Express보다 상당히 빠름 (벤치마크에서 ~2배)
```

NestJS는 **플랫폼 독립적**이므로 Express를 **Fastify**로 교체할 수 있습니다 — HTTP 처리량에서 종종 약 2배 빠르며 — 보통 애플리케이션 코드 변경 없이. 고처리량 API를 위한 쉬운 승리입니다.

## 데이터베이스가 보통 실제 병목입니다

```ts
// ❌ N+1 쿼리 — 루프에서 연관 데이터 가져오기 (가장 흔한 성능 킬러)
for (const user of users) {
  user.posts = await postsRepo.findByUser(user.id);   // 사용자당 1쿼리!
}

// ✅ eager load / join / 하나의 쿼리로 배치
const users = await usersRepo.find({ relations: ["posts"] });
```

```text
데이터베이스 최적화 (대부분의 API에 가장 큰 실제 승리):
  ✓ N+1 쿼리 수정 (join/relation/DataLoader 사용)
  ✓ 느린 쿼리에 인덱스 추가
  ✓ 필요한 컬럼만 select; 큰 결과 집합 페이지네이션
  ✓ 연결 풀링 사용
```

## 비싼 작업 캐싱

```ts
@UseInterceptors(CacheInterceptor)   // 읽기가 많은 엔드포인트 캐싱 (인메모리 또는 Redis)
// 또는 비싼 쿼리/계산의 수동 캐싱
```

캐싱(여러 인스턴스에는 Redis로)은 비싼 작업의 반복을 피합니다 — 가장 영향력이 큰 최적화 중 하나입니다.

## 비동기/동시성과 offloading

```ts
// 독립적인 비동기 작업 병렬화
const [users, products] = await Promise.all([getUsers(), getProducts()]);

// 무거운 CPU 작업을 queue/worker로 offload (이벤트 루프를 막지 않음)
await this.queue.add("process-image", data);
```

독립적인 I/O를 `Promise.all`로 병렬화하고, CPU가 무거운 작업을 백그라운드 queue/worker로 offload하여 Node의 단일 스레드 이벤트 루프를 막지 않게 합니다.

## 기타 기법

```text
✓ 응답에 압축(gzip/brotli) 활성화
✓ 큰 페이로드/파일에 스트리밍 사용
✓ 수평 확장 (여러 인스턴스 + 로드 밸런서; cluster/PM2)
  — 앱을 STATELESS로 유지 (session/cache를 프로세스 메모리가 아닌 Redis에)
✓ 적절한 곳에서 module 지연 로딩; 시작 작업 최소화
✓ clinic.js / node --prof로 프로파일링하여 실제 핫스팟 찾기
```

## 먼저 측정하세요

```text
추측하지 마세요. 프로파일링(clinic.js, 부하 테스트용 autocannon)으로 실제
병목을 찾으세요 — 대부분의 API에서 그것은 Nest/Node 코드가 아니라
데이터베이스나 외부 I/O입니다.
```

## 왜 중요한가

성능 최적화는 확장 가능한 NestJS service를 구축하는 데 가치가 있으며, 옵션을 이해하는 것은 중요한 시니어 수준 지식입니다 — 하지만 **측정 기반**이어야 합니다(실제 병목을 찾기 위해 프로파일링하며, 대부분의 API에서 그것은 NestJS 자체가 아니라 데이터베이스나 I/O입니다).

몇 가지 NestJS 특화 및 일반 기법이 중요합니다: **Fastify 어댑터**는 NestJS가 플랫폼 독립적인 덕분에 쉽고 상당한 HTTP 처리량 승리(약 2배)를 제공하며, 보통 코드 변경 없이; **데이터베이스 최적화**(N+1 쿼리 수정, 인덱싱, 페이지네이션, 풀링)는 데이터베이스가 보통 진짜 병목이므로 가장 큰 실제 이득을 제공; **캐싱**(인메모리 또는 Redis)은 반복적인 비싼 작업을 피함; 독립적인 비동기 작업을 **병렬화**하고 CPU가 무거운 작업을 queue로 **offload**하는 것은 Node의 단일 스레드 이벤트 루프를 반응적으로 유지; 그리고 **수평 확장**(stateless 앱과 Redis 기반 공유 상태로)은 높은 부하를 처리합니다.

이 도구 세트 — 그리고 특히 먼저 프로파일링하고, 실제 병목(보통 DB)을 겨냥하고, 추측하거나 성급하게 마이크로 최적화하는 대신 올바른 수정을 적용하는 규율 — 을 아는 것이 빠르고 확장 가능한 NestJS 애플리케이션을 구축하게 합니다.

이는 시니어 개발자를 구분 짓는 성숙하고 체계적인 성능 접근을 반영하며 프로덕션 백엔드 작업에 흔하고 실무적으로 중요한 주제입니다.