import { revalidateTag } from 'next/cache';
import { NextRequest, NextResponse } from 'next/server';
export async function POST(request: NextRequest) {
const secret = request.headers.get('x-revalidate-secret');
if (secret !== process.env.REVALIDATION_SECRET) {
return NextResponse.json({ message: 'Unauthorized' }, { status: 401 });
}
const { tag } = await request.json();
if (!tag) {
return NextResponse.json({ message: 'Tag missing' }, { status: 400 });
}
revalidateTag(tag);
return NextResponse.json({ revalidated: true, now: Date.now() });
}Văd des în code review-uri un reflex ciudat: lumea pune revalidate: 60 absolut peste tot și speră să fie bine. În producție, asta înseamnă fie că baza de date primește interogări inutile când ai spike-uri de trafic, fie că userii văd prețuri vechi fix când nu trebuie.
Fiecare strategie are un cost ascuns. Dacă înțelegi cum circulă cache-ul în App Router, economisești bani de infrastructură și scapi de bug-uri penibile de sincronizare.
Diferența pragmatică dintre cele trei
SSG (Static Site Generation) generează HTML la build time. Rapid la servire, zero încărcare pe server, dar complet orb la modificări până la următorul deploy.
ISR pe bază de timp (revalidate: X) generează pagina static, dar o regenerează în fundal după ce expiră fereastra de secunde, la prima vizită nouă. Sună bine în teorie. În practică, ai mereu o perioadă de "stale data" și pierzi controlul exact asupra momentului când se schimbă conținutul.
On-Demand Revalidation (revalidatePath sau revalidateTag) combină viteza SSG-ului cu prospețimea datelor dinamice. Pagina stă nemișcată în CDN până când aplicația ta primește un webhook că s-a schimbat ceva în DB sau CMS.
5 scenarii reale de producție
1. Blog tehnic sau documentație (100 - 500 pagini)
Alegerea: SSG curat. La volumul ăsta, build-ul durează sub 20 de secunde pe orice CI/CD decent. Nu ai nevoie de mecanisme complexe de invalidare. Când scrii un articol nou sau corectezi un typo, un git push și deploy-ul rezolvă totul fără complexitate în plus.
2. E-commerce cu catalog mare (15.000+ SKU-uri)
Alegerea: Hibrid SSG + On-Demand Revalidation.
La un magazin la care am lucrat, aveam 14k produse. Build-ul dura 28 de minute dacă generam tot. Am rezolvat problema generând la build doar primele 100 de produse cele mai vizitate (cu generateStaticParams), iar restul la cerere. Când un preț se schimbă în ERP, trimitem un webhook și invalidăm strict tag-ul acelui produs (revalidateTag('product-123')). Build time-ul a scăzut la 80 de secunde, iar prețurile sunt mereu corecte.
3. Site de știri sau publicație media
Alegerea: On-Demand Revalidation prin Webhook din CMS.
Nu pune ISR cu 30 de secunde. Dacă ai 50.000 de unici pe un breaking news, nu vrei ca serverul să tot încerce să randeze pagina în fundal. Configurează CMS-ul (Strapi, Sanity, Contentful) să trimită un POST la /api/revalidate când editorul dă click pe "Publish". Pagina se regenerează instant o singură dată.
4. Dashboard B2B / Panou intern cu login
Alegerea: Dinamic pur (no-store / Dynamic Rendering).
Aici SSG și ISR sunt complet contraindicate. Datele sunt per-user, se bazează pe cookies/sesiune și nu vrei sub nicio formă să risti să cache-uiești date financiare sau date personale între utilizatori.
5. Pagina de Pricing / Landing marketing
Alegerea: SSG cu On-Demand, exclus ISR. Paginile de conversie trebuie să aibă TTFB sub 50ms direct din marginea CDN-ului. Schimbi prețurile o dată pe trimestru, deci orice revalidare bazată pe timp este pură risipă.
Trade-off-ul de reținut
ISR pe timp e util doar când consumi date dintr-un API terț pe care nu-l controlezi și nu-ți poate trimite webhook-uri (de exemplu, cotații valutare sau vreme). În rest, dacă controlezi sursa de date, On-Demand Revalidation bate ISR-ul la orice oră.
Voi mai folosiți ISR pe intervale de timp în producție, sau ați mutat totul pe tag-uri?