# 1. Urmărește memoria și CPU în timp real în alt terminal
htop
# 2. Mărește limita de memorie pentru Node dacă ai RAM fizic
NODE_OPTIONS="--max-old-space-size=4096" next build
# 3. Verifică dacă swap-ul o ia razna în timpul build-ului
vmstat 1 10Am pățit treaba asta acum trei săptămâni pe un magazin online migrat de pe Vercel pe un VPS Hetzner de 4 vCPU și 8GB RAM. Pe Mac-ul meu de dev, un next build termina totul în 45 de secunde, iar în dev paginile porneau instant. Pe VPS, terminalul îngheța la pasul de compilare a rutelor și stăteam 8 minute și ceva cu ochii în consolă.
Dacă treci prin asta, nu sări direct să cumperi un server mai mare. În 90% din cazuri, problema e o combinație idioată între lipsa de memorie și generarea statică.
1. Verifică dacă intri în swap thrashing
Next.js este un consumator masiv de memorie în faza de build. Webpack (sau Turbopack) împinge memoria spre 3-4GB fără jenă pe proiecte medii.
Când Node.js depășește memoria RAM disponibilă, Linux începe să scrie paginile de memorie pe disk în swap. Dacă nu ai un NVMe ultra-rapid sau dacă swap-ul e pe un disk lent, CPU-ul stă 90% din timp în iowait, așteptând disk-ul. Din acest motiv, procesorul pare că stă la 100%, dar în realitate nu compilează nimic — doar plimbă date de pe disc în RAM.
Deschide un al doilea terminal pe server și rulează htop în timp ce pornești build-ul. Dacă bara de SWAP crește și ajunge pe roșu, ai găsit vinovatul.
Soluția rapidă: setează NODE_OPTIONS="--max-old-space-size=4096" doar dacă ai RAM fizic. Dacă nu ai, pune măcar un swapfile de 4GB pe SSD rapid, dar fii conștient de trade-off: build-ul va trece, însă tot va dura 2-3 minute în loc de 40 de secunde.
2. generateStaticParams și apelurile externe
A doua mare capcană: paginile statice (SSG). Dacă ai rute dinamice gen [slug] și folosești generateStaticParams, Next.js încearcă să prerandeze acele pagini la build time.
La proiectul menționat, aveam vreo 1.200 de produse. La fiecare produs, rula un query către un backend separat. Problema? Backend-ul nostru avea un rate limit silențios sau răspundea în 150ms. Înmulțește 1.200 cu 150ms împărțit la numărul de thread-uri paralele din Next și obții minute bune de așteptare în gol.
Verifică output-ul din consolă: unde stă cel mai mult? Dacă stă la simbolul ● (SSG) generând rute, fă un test simplu. Înlocuiește temporar lista aia de parametri cu doar 5-10 bucăți. Dacă build-ul scade de la 8 minute la 1 minut, problema e latența rețelei către API-ul extern, nu compilatorul.
3. Cache-ul de build și Docker
Dacă faci build-ul într-un container Docker direct pe VPS, verifică dacă nu cumva arunci cache-ul la fiecare rulare. Directorul .next/cache conține tot rezultatul compilărilor anterioare.
Fără un volum mapat pentru .next/cache, fiecare deploy este un "cold build" de la zero. Local ai mereu cache-ul cald de la sesiunea anterioară de lucru, de aia pe laptop zboară.
Pentru Docker, un simplu cache-from sau un volume montat temporar pentru .next/cache a redus timpul nostru de la 8 minute la 1 minut și 40 de secunde.
Voi cum rulați Next.js pe VPS-uri proprii: build direct pe mașină, imagine pre-construită în GitHub Actions/GitLab CI sau lăsați totul pe platforme dedicate?