# [[Node.js Memory Tuning]]

## 📌 Brief Summary
Node.js 메모리 튜닝은 V8 자바스크립트 엔진에서 실행되는 Node.js 애플리케이션의 메모리 사용량을 모니터링, 관리 및 최적화하는 과정입니다 [1]. 이 튜닝의 핵심은 V8이 메모리를 힙(New Space 및 Old Space)과 스택으로 구성하는 방식과 가비지 컬렉션(GC)을 통해 메모리를 회수하는 방식을 이해하는 것입니다 [1, 2]. 개발자는 특정 명령줄 플래그를 사용하여 힙 크기와 GC 주기를 조정함으로써 애플리케이션의 성능을 향상시키고 메모리 부족(Out-of-memory)으로 인한 충돌을 방지할 수 있습니다 [1, 3-5].

## 📖 Core Content

**V8 메모리 아키텍처의 이해**
*   V8은 메모리를 주로 **힙(Heap)**과 **스택(Stack)**으로 나누어 관리합니다 [2, 6]. 
*   **스택(Stack):** 정적 데이터, 지역 변수, 함수 호출 정보가 LIFO(Last In, First Out) 방식으로 저장되는 작고 빠른 영역입니다 [6].
*   **힙(Heap):** 객체, 배열, 함수와 같은 동적 데이터가 할당되는 큰 영역이며, 가비지 컬렉터에 의해 관리됩니다 [6, 7]. 힙은 다시 단기 생존 객체가 생성되는 **New Space**(Young Generation)와 여러 번의 GC 주기를 버텨낸 장기 생존 객체가 보관되는 **Old Space** 등으로 세분화됩니다 [2, 7].

**메모리 모니터링 및 누수 탐지**
*   메모리를 튜닝하기 전에 `process.memoryUsage()` 메서드를 사용하여 애플리케이션의 메모리 소비량을 모니터링해야 합니다 [8, 9]. 이 메서드는 RSS(Resident Set Size), `heapTotal`, `heapUsed`, `external`, `arrayBuffers` 등의 메모리 지표를 반환합니다 [9].
*   시간이 지나도 `heapUsed`가 반환되지 않고 지속적으로 증가한다면 메모리 누수를 나타내는 신호일 수 있습니다 [3].
*   `--trace-gc` 플래그를 사용하면 Scavenge(New Space GC)와 Mark-sweep(Old Space GC) 등의 가비지 컬렉션 이벤트를 콘솔에서 추적하여 메모리가 해제되는 상태와 GC 소요 시간을 분석할 수 있습니다 [10-12].

**명령줄 플래그를 활용한 메모리 튜닝**
Node.js는 메모리 최적화를 위해 V8 엔진의 메모리 관련 설정을 미세 조정할 수 있는 여러 명령줄 플래그(Command-Line Flags)를 제공합니다 [3].
*   `--max-old-space-size`: V8 힙에서 수명이 긴 객체들이 저장되는 Old Space의 최대 크기를 제한합니다 [4]. 지속적인 데이터를 많이 처리하는 애플리케이션의 경우, 이 값을 늘려주어(예: `--max-old-space-size=4096`) 잦은 GC로 인한 응답 속도 저하나 충돌을 방지할 수 있습니다 [4, 13].
*   `--max-semi-space-size`: 객체가 처음 할당되는 New Space의 크기를 조절합니다 [13]. 초당 요청 수가 많아 작은 객체가 수없이 생성되는 환경에서 이 값을 늘리면(예: `--max-semi-space-size=64`), 마이너 가비지 컬렉션의 빈도를 줄여 전반적인 성능 저하를 막을 수 있습니다 [5, 13].
*   `--gc-interval`: 가비지 컬렉션이 시도되는 주기를 조정합니다 [5]. 실시간 처리 등 특정 조건에서 GC의 주기를 명시적으로 제어할 필요가 있을 때 사용합니다(예: `--gc-interval=100`) [5, 14].
*   `--expose-gc`: 코드 내부에서 `global.gc()`를 호출하여 개발자가 수동으로 가비지 컬렉션을 실행할 수 있도록 허용하는 플래그입니다 [14, 15].

## 🔗 Knowledge Connections
- **Related Topics:** [[V8 JavaScript Engine]], [[Garbage Collection]], [[Heap Memory]], [[Memory Leaks]]
- **Projects/Contexts:** [[Node.js Production Profiling]], [[Performance Optimization]]
- **Contradictions/Notes:** `--expose-gc` 플래그를 통해 수동으로 가비지 컬렉션을 실행하더라도, V8의 일반적인 자동 GC 알고리즘이 비활성화되는 것은 아닙니다. 수동 호출을 과도하게 사용하면 오히려 성능에 부정적인 영향을 미칠 수 있으므로 주의가 필요합니다 [15]. 또한, `--gc-interval`의 간격을 너무 짧게 설정할 경우 잦은 GC 수행으로 인해 애플리케이션의 성능 저하를 유발할 수 있습니다 [14].

---
*Last updated: 2026-04-19*