Files

T

koriweb d8a80f6272 chore(wiki): dangling 링크 canonical 정규화 (768파일/1200건)

이름만 다른(표기 변형) [[위키링크]]를 대상 문서의 canonical 제목으로 치환해
끊겼던 1,200개 링크를 연결. 제목/파일명 정규화 일치만 적용하고 별칭 매칭은
과병합 위험으로 제외(애매성 가드). 원본은 _link_reconcile_backup/ 에 백업.
도구: Datacollect/scripts/link_reconcile_apply.mjs

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

2026-06-08 12:24:15 +09:00

6.6 KiB

Raw Blame History

id, title, category, status, canonical_id, aliases, duplicate_of, source_trust_level, confidence_score, tags, raw_sources, last_reinforced, github_commit, inferred_by, tech_stack

title

Nodejs_and_Backend_Optimization

📌 한 줄 통찰 (The Karpathy Summary)

"메모리는 유실되는 것이 아니라 붙잡혀 있는 것이다." Node.js의 고성능 백엔드 구축은 V8 엔진의 세대별 가비지 컬렉션(GC) 메커니즘을 이해하고, 클로저·이벤트 리스너·캐시 등에서 발생하는 '래칫(Ratchet)' 패턴의 메모리 누수를 힙 스냅샷과 할당 타임라인으로 정밀 타격하여 제거하는 과정입니다.

📖 구조화된 지식 (Synthesized Content)

1. V8 메모리 구조 및 가비지 컬렉션 (GC)

세대별 가설 (Generational Hypothesis): "대부분의 객체는 일찍 죽는다." V8은 이를 기반으로 힙(Heap)을 **New Space(Young Generation)**와 **Old Space(Old Generation)**로 분리 관리합니다.
Minor GC (Scavenger): New Space에서 짧은 수명의 객체를 매우 빠르게 정리합니다. 여러 번 살아남은 객체는 Old Space로 **승격(Promotion)**됩니다.
Major GC (Mark-Sweep-Compact): Old Space의 장기 객체를 정리합니다. 실행 비용이 크며, 메모리 파편화를 줄이기 위해 압축(Compaction)을 수행합니다.
Orinoco GC: 메인 스레드 중단(Stop-the-world)을 최소화하기 위해 병렬(Parallel), 점진적(Incremental), 동시(Concurrent) 기법을 결합하여 백그라운드에서 메모리를 회수합니다.

2. 메모리 누수 패턴 (The "Ratchet" Effect)

정상적인 시스템은 트래픽에 따라 힙이 증가했다가 GC 후 복구되는 '톱니바퀴(Sawtooth)' 패턴을 보이지만, 누수가 있으면 하한선이 계속 상승하는 '계단식(Ratchet)' 패턴이 나타납니다.

이벤트 리스너 누적: on() 호출 후 removeListener()를 누락하여 MaxListenersExceededWarning이 발생하는 경우 (가장 흔한 패턴).
클로저 변수 유지: 비동기 콜백이나 타이머가 대규모 데이터(요청/응답 객체 등)를 캡처한 채 종료되지 않는 경우.
무제한 캐시 증식: LRU 등 크기 제한이 없는 인메모리 캐시 변수에 데이터가 무한정 쌓이는 경우.
정리되지 않은 타이머/소켓: clearInterval되지 않은 타이머나 .destroy()되지 않은 스트림/소켓이 버퍼를 점유하는 경우.

3. 진단 도구 및 워크플로우

Chrome DevTools & --inspect: 실시간 메모리 프로파일링 및 힙 스냅샷 분석의 표준.
힙 스냅샷 (Heap Snapshot): 특정 시점의 메모리 상태를 캡처. **3-스냅샷 기법(Three-snapshot technique)**을 통해 일회성 할당을 걸러내고 지속적인 누수 후보를 특정합니다.
할당 타임라인 (Allocation Timeline): 시간에 따른 할당을 시각화. GC 후에도 파란색 막대로 남은 객체가 누수 지점입니다.
유지 경로 (Retaining Path): 특정 객체가 왜 해제되지 않는지 GC 루트까지의 참조 체인을 추적합니다.
명령줄 플래그:
- --max-old-space-size: OOM 방지를 위한 힙 크기 확장.
- --trace-gc: GC 발생 빈도 및 소요 시간 로그 확인.
- --heap-prof: 외부 패키지 없이 V8 네이티브 프로파일링 수행.

4. 백엔드 최적화 전략

싱글 스레드 보호: CPU 집약적 작업은 Worker Threads로 분리하여 이벤트 루프 블로킹 방지.
스트림 활용: 대용량 파일/데이터 처리 시 전체를 메모리에 올리지 않고 Buffer 단위로 처리.
가시성 (Observability): prom-client 등을 활용해 RSS, heapUsed 메트릭을 Prometheus/Grafana로 모니터링하고 임계치 알람 설정.

⚖️ 트레이드오프 및 주의사항 (Trade-offs)

수동 GC의 위험성: --expose-gc를 통한 global.gc() 호출은 특수한 배치 작업 외에는 권장되지 않으며, V8의 최적화된 자동 GC 메커니즘을 방해할 수 있습니다.
포인터 압축 (Pointer Compression): 64비트 시스템에서도 V8 힙을 4GB로 제한하는 구조적 한계가 있어, 대규모 데이터를 다룰 때 주의가 필요합니다.
조급한 최적화 금지: 초기 단계에서의 과도한 메모리 튜닝보다는 정확한 누수 지점 파악이 선행되어야 합니다.

🔗 지식 연결 (Graph)

Parent: 10_Wiki/Topics
Related: Cloud_Native, Modern_Web_Rendering_and_Optimization, Performance_Profiling_and_Memory
Redirects: Nodejs_and_Backend_Optimization, Allocation Timeline, Heap Snapshot, Nodejs_and_Backend_Optimization, Nodejs_and_Backend_Optimization

Last updated: 2026-05-08

🤖 LLM 활용 힌트 (How to Use This Knowledge)

언제 이 지식을 쓰는가:

(TODO)

언제 쓰면 안 되는가:

(TODO)

🧪 검증 상태 (Validation)

정보 상태: needs_review
출처 신뢰도: A
검토 이유: (P-Reinforce Phase 1 자동 정규화. 본문 검증 필요.)

🧬 중복 검사 (Duplicate Check)

기존 유사 문서: (TODO: 인덱서 클러스터 리포트 참조)
처리 방식: UPDATE (자동 정규화)
처리 이유: Phase 1 정규화 — 옛 템플릿/누락 필드 보강.

⚠️ 모순 및 업데이트 (Contradictions & Updates)

과거 데이터와의 충돌: 없음
정책 변화: 없음

🕓 변경 이력 (Changelog)

날짜	변경 내용	처리 방식	신뢰도
2026-05-08	P-Reinforce Phase 1 정규화 (frontmatter + 헤더 표준화)	UPDATE	A

💻 코드 패턴 (Code Patterns)

패턴 1: (TODO: 이 프로젝트 컨벤션 반영한 구조 스켈레톤)

# TODO

🤔 의사결정 기준 (Decision Criteria)

선택 A를 써야 할 때:

(TODO)

선택 B를 써야 할 때:

(TODO)

기본값:

(TODO)

❌ 안티패턴 (Anti-Patterns)

[안티패턴]: (TODO: 무엇을 하면 안 되는가 + 이유 + 대신 무엇을)

6.6 KiB Raw Blame History