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

Next.js ISR vs SSG vs On-Demand Revalidation: ghid practic pe 5 cazuri reale

De Florin Manea, 7 nov. 2026 · 15 vizualizări · 3 like-uri

Postat 7 nov. 2026
typescript
// app/api/webhook/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: 'Unauthorized' }, { status: 401 });
  }

  const { productId } = await request.json();
  if (!productId) {
    return NextResponse.json({ message: 'Missing product ID' }, { status: 400 });
  }

  // Invalidează doar fetch-urile tag-uite specific
  revalidateTag(`product-${productId}`);

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

De fiecare dată când aud pe cineva zicând că pune revalidate = 60 peste tot în App Router „ca să fie rapid”, îmi aduc aminte de un magazin online cu 42.000 de SKU-uri unde build-ul pe Vercel dura 38 de minute. Next.js îți dă libertate totală pe caching, dar dacă nu știi diferența dintre cache static, cache expirat în timp și invalidare țintită, plătești scump la factură sau la clienți nervoși că văd prețuri vechi.

Hai să tranșăm opțiunile direct, fără teorie academică.

Mental model: cum gândești cache-ul în App Router

  • SSG pur (Static): Pagina se generează la next build și rămâne identică până la următorul deploy. Super rapid, 0ms TTFB pe edge, dar complet inert dacă se schimbă ceva în DB fără build nou.
  • ISR time-based (export const revalidate = 300): Next servește versiunea cached. După ce trec 5 minute, primul vizitator primește tot varianta veche (stale), dar declanșează un render în fundal. Următorul vizitator vede datele noi. E o alegere bună când toleranța la date ușor desincronizate e acceptabilă.
  • On-Demand Revalidation (revalidateTag / revalidatePath): Pagina stă în cache la nesfârșit (ca la SSG), dar când modifici ceva în CMS sau panoul de admin, tragi un webhook care golește instant cheia aia de cache. Cel mai bun raport între viteză și date proaspete.

5 cazuri reale și ce alegi la fiecare

1. Blog tehnic sau pagini de Legal (Terms, Privacy)

Alegere: SSG pur. Modifici o dată la câteva luni. N-are absolut niciun sens să lași serverul să verifice timere sau să asculte webhook-uri complexe. Generezi totul la build, pui pe CDN și ai terminat.

2. Pagina de produs (E-commerce cu sute/mii de SKU-uri)

Alegere: On-Demand Revalidation via tags. Dacă folosești time-based ISR (ex: 60 secunde), ai două mari bube: dacă ai 30.000 de produse rar vizitate, generezi pagini degeaba la primul request lent; dacă un produs își schimbă stocul sau prețul, vizitatorul poate prinde 60 de secunde de date eronate și cumpără la preț vechi. Cu revalidateTag('product-123') legat la webhook-ul din ERP, pagina rămâne ultra-rapidă (cache hit 99%), dar la salvare în admin devine instant actualizată.

3. Listing de categorii cu filtre standard

Alegere: ISR time-based (300 - 900 secunde). La categorii nu merită să faci purge la fiecare schimbare minoră de produs, pentru că invalidezi prea multe rute în lanț. Un cache de 5-15 minute este arhisuficient; utilizatorii tolerează perfect dacă un produs nou apare în categorie cu o mică întârziere.

4. Panou de control B2B / Dashboard utilizator

Alegere: Dynamic Rendering (SSR pur, no-store). Aici văd cele mai mari gafe. Încearcă unii să bage ISR pe dashboard-uri private. Dacă depinzi de cookie-uri, sesiuni de auth sau date specifice per user, nu ai ce căuta cu pagini statice. Mergi pe dynamic = 'force-dynamic' sau fetch(..., { cache: 'no-store' }).

5. Documentație tehnică versionată

Alegere: SSG combinat cu on-demand revalidate la commit pe GitHub. Docs-urile trebuie să fie fulger. Le randezi static, dar configurezi un API route /api/revalidate chemat de un GitHub Action pe branch-ul main. Scapi complet de deploy-uri de 10 minute pentru un typo rezolvat într-un fișier markdown.

Compromisul de care nu vorbește multă lume

On-demand revalidation sună perfect pe hârtie, dar cere disciplină: dacă ERP-ul tău dă batch update la 10.000 de produse la ora 02:00 noaptea și tu tragi 10.000 de apeluri de revalidateTag simultan, s-ar putea să-ți omori baza de date când vin primele request-uri peste paginile invalidate. Pentru cataloage gigantice, o combinație de ISR time-based lung (24h) + revalidare selectivă e deseori mai sigură.

Voi cum ați rezolvat problema invalidării pe proiecte cu volum mare în App Router?

Răspunsuri 0

Se încarcă răspunsurile…

Loghează-te pentru a răspunde

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