eduardweb.
App RouterIntermediar#performance#nextjs#caching#app-router

SSG, ISR sau On-Demand Revalidation în Next.js? Ghid practic din producție

De George Iliescu, 19 oct. 2026 · 30 vizualizări · 2 like-uri

Postat 19 oct. 2026
typescript
// app/api/revalidate/route.ts
import { revalidateTag } from 'next/cache';
import { NextRequest, NextResponse } from 'next/server';

export async function POST(request: NextRequest) {
  const secret = request.headers.get('x-webhook-secret');
  
  if (secret !== process.env.CMS_WEBHOOK_SECRET) {
    return NextResponse.json({ message: 'Invalid token' }, { status: 401 });
  }

  const body = await request.json();
  const productId = body?.productId;

  if (!productId) {
    return NextResponse.json({ message: 'Missing productId' }, { status: 400 });
  }

  // Invalidează cache-ul doar pentru acest produs specific
  revalidateTag(`product-${productId}`);

  return NextResponse.json({ revalidated: true, now: Date.now() });
}

M-am săturat să văd proiecte unde echipa pune export const revalidate = 60 pe toate paginile din comoditate, iar apoi se miră de ce baza de date e îngenuncheată de crawlere. În Next.js App Router, granița dintre static și dinamic e mai fină ca niciodată, dar dacă iei decizia greșită de la început, plătești la factura de hosting sau la nervii utilizatorilor.

Am adunat regulile mele de fier, testate după câteva refactorizări dureroase pe platforme cu trafic serios.

1. SSG pur: bun pentru liniște, groaznic când crești

Generarea statică la build (force-static sau fetch-uri fără cache disabled) e sfântul graal pentru viteză: TTFB sub 40ms servit direct din CDN. Nu ai baze de date apelate la runtime, nu ai serverless functions care se trezesc din cold start.

Unde crapă? La scală. La un magazin cu vreo 35.000 de produse, am insistat prostește pe SSG pur la lansare. Rezultatul: build-ul pe CI dura 24 de minute, iar dacă pica un singur request spre API-ul de ERP la produsul cu numărul 32.000, pica tot deployment-ul. Păstrează SSG-ul pur exclusiv pentru pagini cu volum controlat: pagini de termeni și condiții, documentație, landing page-uri instituționale sau bloguri mici (sub 500 de articole).

2. Time-based ISR: util, dar adesea abuzat

ISR cu timer (next: { revalidate: 3600 }) e excelent când datele se schimbă rar și nu e critic dacă un user vede un preț vechi timp de câteva minute.

Trade-off-ul pe care mulți îl ignoră este modelul stale-while-revalidate. Primul vizitator care accesează pagina după expirarea timpului primește tot pagina veche, iar serverul generează noua versiune în fundal. Dacă ai trafic mic pe o pagină de nișă, acel conținut poate rămâne învechit mult peste intervalul setat. Funcționează bine pe listări de produse, agregatoare de știri sau clasamente unde consistența instantanee nu e cerință de business.

3. On-Demand Revalidation: arma secretă pentru e-commerce

În loc să ghicești din cât în cât timp se schimbă datele, lași sistemul sursă (CMS-ul sau ERP-ul) să-ți spună când s-a modificat ceva. Folosești revalidateTag() sau revalidatePath() declanșate de un webhook.

Ai actualizat prețul la o șurubelniță în Sanity sau Shopify? Webhook-ul trimite un request semnat către API-ul tău de Next.js, apelezi tag-ul asociat produsului, iar la următorul request pagina e deja proaspătă. Nu mai consumi cicluri de procesor inutil pe mii de pagini nemodificate.

Diagrama rapidă: 5 cazuri din viața reală

  1. Blog de companie sau docs (sub 1.000 pagini): SSG pur. Build-ul durează sub 2 minute. Când scrii un articol nou, dai trigger la un build automat din GitHub Actions sau CMS.
  2. Pagina de Detaliu Produs (PDP) în magazin mediu/mare: On-demand via revalidateTag. Conținutul e servit static din CDN cu viteze maxime, iar dacă stocul sau prețul se modifică, invalidezi doar tag-ul product-${id}.
  3. Pagina de Categorie / Filtre (PLP): Time-based ISR (ex: 300 - 900 secunde) sau Dynamic Rendering (SSR) cu streaming Suspense dacă ai zeci de fațete și filtre URL combinate. Să generezi static toate combinațiile de filtre e sinucidere curată.
  4. Dashboard de analytics / Contul clientului: Dynamic pur (no-store / SSR). Niciodată nu vrei să riști ca utilizatorul A să vadă prin CDN bucăți din profilul sau rapoartele utilizatorului B. Randare pe server per-request, protejată de auth middleware.
  5. Pagină de evenimente cu bilete limitate: Dynamic cu fallback la client. Generarea statică aici te expune la race conditions oribile unde arăți bilete disponibile care s-au vândut deja.

Voi cum ați rezolvat sincronizarea stocurilor în App Router? Mergeți pe tag-uri per SKU sau citiți stocul strict pe client?

Răspunsuri 0

Se încarcă răspunsurile…

Loghează-te pentru a răspunde

Doar membrii comunității pot lăsa comentarii.