메모리 관리: 프로파일링 + 누수 탐지

// 주기적 메모리 보고
setInterval(() => {
  const mem = process.memoryUsage();
  console.log({
    rss: `${Math.round(mem.rss / 1024 / 1024)}MB`,        // 전체 RAM
    heapTotal: `${Math.round(mem.heapTotal / 1024 / 1024)}MB`,
    heapUsed: `${Math.round(mem.heapUsed / 1024 / 1024)}MB`,
    external: `${Math.round(mem.external / 1024 / 1024)}MB`,
  });
}, 60000);


// Sentry 자동 전송
import * as Sentry from '@sentry/node';
setInterval(() => {
  Sentry.metrics.gauge('memory.heap_used', process.memoryUsage().heapUsed);
}, 30000);

// 1. 글로벌 변수 누적
const cache = {};  // ❌ 무한 성장

// ✅ 제한된 캐시 (LRU)
import LRU from 'lru-cache';
const cache = new LRU({ max: 1000, ttl: 1000 * 60 * 5 });


// 2. Event Listener 누수
const listener = () => doSomething();
emitter.on('event', listener);
// ❌ 제거 안 함

// ✅
emitter.off('event', listener);


// 3. Closure 누수
function makeHandler() {
  const big = new Array(1000000);  // 큰 객체
  return function() {
    return 'small';  // big 참조 안 하지만 closure에 잡힘
  };
}

// ✅
function makeHandler() {
  return function() {
    return 'small';
  };
}


// 4. setInterval 누수
const interval = setInterval(work, 1000);
// ❌ clearInterval 안 하면 GC 안 됨

// ✅
clearInterval(interval);


// 5. Stream 미닫기
const stream = fs.createReadStream(file);
// ❌ 에러 시 close 안 함

// ✅
stream.on('error', () => stream.destroy());
stream.on('end', () => stream.destroy());

# Node.js 헤프 덤프
node --inspect server.js
# → chrome://inspect → Memory 탭 → Heap Snapshot


# 또는 v8.writeHeapSnapshot
import v8 from 'v8';
process.on('SIGUSR2', () => {
  const file = `heap-${Date.now()}.heapsnapshot`;
  v8.writeHeapSnapshot(file);
  console.log(`Snapshot: ${file}`);
});


# 트리거
kill -SIGUSR2 <pid>

// ❌ unmount 후 setState
function Component() {
  const [data, setData] = useState();
  useEffect(() => {
    fetch('/api').then(r => r.json()).then(setData);  // unmount 후 호출 가능
  }, []);
}


// ✅ AbortController + cleanup
function Component() {
  const [data, setData] = useState();
  useEffect(() => {
    const controller = new AbortController();
    fetch('/api', { signal: controller.signal })
      .then(r => r.json())
      .then(setData)
      .catch(err => {
        if (err.name === 'AbortError') return;
        // ...
      });
    return () => controller.abort();
  }, []);
}


// ❌ subscription 누수
useEffect(() => {
  socket.on('event', handler);
  // cleanup 누락
}, []);


// ✅
useEffect(() => {
  socket.on('event', handler);
  return () => { socket.off('event', handler); };
}, []);

// ❌ 큰 파일 전체 로드
import fs from 'fs/promises';
const content = await fs.readFile('big.csv');  // 1GB → 1GB 메모리


// ✅ Stream
import { createReadStream } from 'fs';
import { parse } from 'csv-parse';

const parser = createReadStream('big.csv').pipe(parse({ columns: true }));

for await (const row of parser) {
  await processRow(row);  // 한 줄씩
}
// → 메모리 KB 수준


// ❌ JSON.stringify 큰 배열
const json = JSON.stringify(millionItems);  // OOM


// ✅ JSONStream
import JSONStream from 'JSONStream';
const stream = JSONStream.stringify('[\n', ',\n', '\n]');
items.forEach(item => stream.write(item));
stream.end();

// PM2 설정 — max_memory_restart
module.exports = {
  apps: [{
    name: 'api',
    script: 'server.js',
    instances: 4,
    max_memory_restart: '500M',  // 500MB 초과 시 재시작
  }],
};


// Kubernetes
resources:
  limits:
    memory: 512Mi
  requests:
    memory: 256Mi


// → OOM 방지 + 자동 복구

pnpm dlx clinic doctor -- node server.js
# → 부하 줘서 진단

pnpm dlx clinic heap-profile -- node server.js
# → 메모리 분석

pnpm dlx clinic flame -- node server.js
# → CPU 핫스팟