빌드 OOM은 왜 발생하나요?

빌드 단계에서 필요한 메모리보다 CI 러너 메모리가 부족하거나, 소스맵/플러그인/병렬 처리로 메모리 사용량이 급증해 발생합니다.

가장 빠른 임시 대응은 무엇인가요?

NODE_OPTIONS=--max-old-space-size 값을 적용해 임시로 메모리를 늘리고, 이후 빌드 옵션 최적화로 근본 원인을 줄이세요.

Choorai | 문서

CI 빌드 메모리 이슈

JavaScript heap out of memory, Killed 오류는 빌드 메모리 한도 초과가 원인입니다.

TL;DR (핵심 요약)

1) OOM 로그 확인 2) NODE_OPTIONS로 임시 완화 3) 소스맵/플러그인/병렬도 최적화 4) 필요 시 CI 러너 스펙 상향

심각

원인

빌드 프로세스가 허용 메모리 한도를 초과했습니다.

해결책

package.json

{
  "scripts": {
    "build": "vite build",
    "build:ci": "NODE_OPTIONS=--max-old-space-size=4096 vite build"
  }
}

vite.config.ts

import { defineConfig } from 'vite';

export default defineConfig({
  build: {
    sourcemap: false,
    chunkSizeWarningLimit: 1200,
  },
});

실무 팁

OOM은 증상이고 원인은 번들 구조인 경우가 많습니다. 대용량 라이브러리 lazy load, 번들 분석 도구로 원인 패키지를 먼저 찾아보세요.

입력한 내용으로 새 이슈 페이지를 엽니다.