Компилацията на Next.js е бавна или ѝ свършва паметта в GitHub Actions: кеш, памет, размер на рънъра
Компилацията на Next.js в GitHub Actions е бавна по една причина и ѝ свършва паметта по друга. Бавна е, когато .next/cache не се пренася към следващото изпълнение: Next.js използва този кеш отново между компилациите, задача, хоствана от GitHub, започва на нова VM и без стъпка за кеша всяка компилация е студена (логът казва No Cache Detected). Паметта ѝ свършва, защото ubuntu-latest в частно хранилище има 8 GB, а компилирането с webpack, проверката на типовете и source maps на голямо приложение могат да надхвърлят това. Първото се оправя с actions/cache за .next/cache. За второто първо идват настройките на Next.js за паметта (experimental.webpackMemoryOptimizations, без source maps в production); после машина с повече памет: 16 GB или 32 GB.
Skipbox дава на компилацията тази памет на фиксирана цена: 16 GB и 8 vCPU с runs-on: skipbox-8x16 за $79 на месец, 32 GB и 16 vCPU с skipbox-16x32 за $149. На отделната ви машина .next/cache остава за следващата компилация, кешовете на пакетите остават на диска, а записаното от actions/cache се чете локално, с неограничени минути.
Бавна: .next/cache започва празен
От ръководството на Next.js за кеширане на компилацията в CI: Next.js записва кеш в .next/cache, който се споделя между компилациите, а CI, който не го пази между компилациите, показва грешката No Cache Detected. Стъпката му за GitHub Actions:
- uses: actions/cache@v4
with:
path: |
~/.npm
${{ github.workspace }}/.next/cache
key: ${{ runner.os }}-nextjs-${{ hashFiles('**/package-lock.json') }}-${{ hashFiles('**/*.js', '**/*.jsx', '**/*.ts', '**/*.tsx') }}
restore-keys: |
${{ runner.os }}-nextjs-${{ hashFiles('**/package-lock.json') }}-
Ключът се сменя с всяка промяна в изходния код, така че всяко изпълнение записва нов запис, в рамките на 10-те GB на хранилище в GitHub. В Turborepo изключете .next/cache от outputs на задачата ("!.next/cache/**"), както прави ръководството на Turborepo за GitHub Actions.
Без памет: две различни грешки
| В лога | Какво е свършило | Какво да направите |
|---|---|---|
JavaScript heap out of memory | Собственият лимит на heap на Node; машината още е имала памет | Вдигнете го: NODE_OPTIONS=--max-old-space-size=6144, под паметта на машината |
Process completed with exit code 137 | Паметта на машината: Linux е убил процеса | Използвайте по-малко памет или машина с повече |
Вдигането на heap над паметта на машината превръща първата грешка във втората.
Използвайте по-малко памет: собствените настройки на Next.js
От ръководството на Next.js за използването на памет:
experimental.webpackMemoryOptimizations: true(v15.0.0 и по-нови) намалява пика на паметта на webpack, срещу малко по-дълго компилиране.- Build worker-ът на webpack изпълнява компилирането в отделен Node worker, което намалява паметта. Той е включен по подразбиране от v14.1.0, освен ако нямате собствена конфигурация на webpack; ако имате, задайте
experimental.webpackBuildWorker: true. - Изключени source maps:
productionBrowserSourceMaps: falseиexperimental.serverSourceMaps: false. Ако паметта на компилацията свършва по време на „Generating static pages“, иenablePrerenderSourceMaps: false. - Измервайте:
next build --experimental-debug-memory-usage(v14.2.0 и по-нови) показва използването на heap по време на компилацията и прави heap snapshots близо до лимита. - Проверка на типовете:
typescript.ignoreBuildErrors: trueпрескача проверката на типовете и паметта ѝ и пуска грешките в типовете в компилацията. Next.js предупреждава срещу това, освен ако друга стъпка не проверява типовете.
Използвайте машина с повече памет
| Рънър | Процесор и памет | Кой може да го използва |
|---|---|---|
GitHub ubuntu-latest, частно хранилище | 2 CPU, 8 GB | Всички |
GitHub ubuntu-latest, публично хранилище | 4 CPU, 16 GB | Публични хранилища |
| По-голям рънър на GitHub, 4 или 8 ядра | 16 GB или 32 GB | Организации в GitHub Team и Enterprise Cloud, на минута (по-големи рънъри) |
Skipbox skipbox-8x16 | 8 vCPU, 16 GB | Организации и лични профили, $79 на месец |
Skipbox skipbox-16x32 | 16 vCPU, 32 GB | Организации и лични профили, $149 на месец |
При 20 000 минути на месец рънърът на GitHub с 8 ядра е $422, а Skipbox M е $79; при 16 ядра – $822 срещу $149 за L. Цифрите за GitHub са след включеното в GitHub Team използване.
Какво прави Skipbox за компилация на Next.js
Всеки план идва с отделна машина за профила ви, пазена между задачите:
- Паметта, от която се нуждае компилацията, чрез етикета: 16 GB в M, 32 GB в L. Задайте heap според нея, например
--max-old-space-size=12288в M. - Кешовете на пакетите остават на диска:
~/.npm, хранилището на pnpm,~/.cacheна всеки инструмент и версиите на Node, инсталирани отsetup-node.npm ciчете от тях вместо от регистъра. .next/cacheостава за следващата задача. Машината пази работното ви копие между задачите, а с него и.next/cache, на каквато и дълбочина да го слага monorepo (apps/web/.next/cache). Следващотоnext buildзапочва от него, без стъпка за кеша и безNo Cache Detected. Останалото от.nextи другите непроследени файлове в работното копие се почистват след всяка задача.- Възстановяванията от
actions/cacheчетат машината. Записаното от тях остава до машината, с повече място от 10-те GB на хранилище в GitHub, а възстановяването е локално четене. Запазете стъпката за.next/cacheза задачите, които се изпълняват на нова VM; на отделната ви машина възстановяването оставя пазения кеш както е. - Повече ядра на фиксирана цена. Компилирането и генерирането на статичните страници ги използват, а минутите са неограничени.
| Етикет | Машина | План |
|---|---|---|
skipbox | 4 vCPU · 16 GB | S, $39 на месец |
skipbox-8x16 | 8 vCPU · 16 GB | M, $79 на месец |
skipbox-16x32 | 16 vCPU · 32 GB | L, $149 на месец |
Преминаването е един ред
jobs:
build:
runs-on: skipbox-8x16 # was ubuntu-latest
env:
NODE_OPTIONS: --max-old-space-size=12288
steps:
- uses: actions/checkout@v4
- uses: actions/setup-node@v4
with:
node-version: 22
cache: npm
- uses: actions/cache@v4
with:
path: ${{ github.workspace }}/.next/cache
key: ${{ runner.os }}-nextjs-${{ hashFiles('**/package-lock.json') }}-${{ hashFiles('**/*.js', '**/*.jsx', '**/*.ts', '**/*.tsx') }}
restore-keys: |
${{ runner.os }}-nextjs-${{ hashFiles('**/package-lock.json') }}-
- run: npm ci
- run: npx next build
skipbox-8x16 работи с план M; пробният период изпълнява runs-on: skipbox.
- Влезте в Skipbox с GitHub.
- Инсталирайте приложението Skipbox в GitHub и изберете хранилищата.
- Сменете
runs-onи направете push.
Сигурност
- Машината е само на вашия профил. Задачи на друга компания никога не се изпълняват на нея.
- След всяка задача идентификационните данни, процесите и контейнерите на рънъра се изтриват, както и идентификационните данни на git в пазеното работно копие и непроследените му файлове, освен кешовете на компилацията като
.next/cache. „Чиста VM за всяка задача“ дава вместо това на всяка задача нова машина. - Код от хора без права за запис (например pull request-и от форкове) се изпълнява на нова VM, която чете кешовете ви, но не може да ги променя.
Подробностите са в как са изолирани задачите.
Изпробвайте го с компилацията на Next.js
Пробният период е безплатен за 7 дни или 3000 минути на задачи, което настъпи първо, без карта. Той изпълнява runs-on: skipbox с 16 GB, 2× паметта на ubuntu-latest в частно хранилище: изпробвайте кеша и паметта там и преместете компилация, която се нуждае от повече, на план L (skipbox-16x32, 32 GB).
Често задавани въпроси
Защо next build е бавен в GitHub Actions?
Обикновено защото .next/cache започва празен. Next.js записва кеш на компилацията в .next/cache и го използва отново при следващата компилация, но задача, хоствана от GitHub, е нова VM, така че без стъпка, която пренася .next/cache, всяка компилация е студена, а логът предупреждава No Cache Detected. Добавете actions/cache за .next/cache с ключ по lockfile-а и изходните ви файлове. Останалото време е инсталирането и компилирането на 2 CPU.
Какъв размер рънър да използва компилацията на Next.js в GitHub Actions?
Достатъчно памет за пика на компилацията. ubuntu-latest в частно хранилище има 2 CPU и 8 GB, а компилацията с webpack, проверката на типовете и source maps на голямо приложение на Next.js могат да надхвърлят това. По-големите рънъри на GitHub имат 16 GB при 4 ядра и 32 GB при 8, само в GitHub Team или Enterprise Cloud, на минута. Skipbox дава 16 GB с 8 vCPU с runs-on: skipbox-8x16 за $79 на месец и 32 GB с 16 vCPU с skipbox-16x32 за $149.
Как да оправя JavaScript heap out of memory в компилация на Next.js в GitHub Actions?
Тази грешка е собственият лимит на heap на Node, не паметта на машината. Вдигнете го с NODE_OPTIONS=--max-old-space-size=<MiB>, зададен под паметта на машината. Ако после задачата завърши вместо това с exit code 137, на самата машина ѝ е свършила паметта: намалете паметта на компилацията (experimental.webpackMemoryOptimizations, без source maps в production) или изпълнете на машина с повече памет.
Как да намаля използваната памет при компилацията на Next.js?
От ръководството на Next.js за паметта: опитайте experimental.webpackMemoryOptimizations (v15 и по-нови), оставете build worker-а на webpack включен (по подразбиране без собствена конфигурация на webpack от v14.1.0), изключете productionBrowserSourceMaps и experimental.serverSourceMaps и измервайте с next build --experimental-debug-memory-usage. Прескачането на проверката на типовете с typescript.ignoreBuildErrors спестява памет, но пропуска грешките в типовете, така че го правете само когато друга задача в CI проверява типовете.
Пази ли Skipbox .next/cache между задачите?
Да. Отделната ви машина пази работното копие между задачите, а с него и .next/cache, където и да го е сложил Next.js (apps/web/.next/cache в monorepo), така че следващото next build започва от кеша на предишното без стъпка за кеша. Останалото от .next и другите непроследени файлове в работното копие се почистват след всяка задача. Кешът на npm или pnpm, версиите на Node, инсталирани от setup-node, и слоевете на Docker също остават на диска. Стъпка с actions/cache за .next/cache може да остане: задача на нова VM, например pull request от форк, възстановява от нея, а на отделната ви машина възстановяването оставя пазения кеш както е.
Колко струва да го изпробвам?
Нищо. Пробният период е 7 дни или 3000 минути на задачи, което настъпи първо, без карта, на 4 vCPU и 16 GB: 2× 8-те GB на ubuntu-latest в частно хранилище и колкото по-големия рънър на GitHub с 4 ядра. Изпробвайте кеширането и паметта там; за компилация, която се нуждае от повече, изберете план L и сменете етикета на skipbox-16x32 (32 GB).
Обновено на 19 ноември 2026 г.