Memorizzazione nella cache in Next.js 15: recupero senza cache predefinita, revalidateTag e unstable_cache
Cosa è cambiato con il passaggio a 15
In Next.js 14, fetch nei componenti server veniva memorizzato nella cache per impostazione predefinita. In 15 questo comportamento è stato invertito:
fetchnon viene memorizzato nella cache a meno che non si specifichi esplicitamentecache: 'force-cache'onext.revalidate.- I gestori GET nei gestori di route non vengono memorizzati nella cache per impostazione predefinita.
- La cache del router client per le pagine non contiene più segmenti di 30 secondi:
staleTimeper le pagine dinamiche è zero.
Una storia tipica dopo un aggiornamento: il carico sull'API o sul database è aumentato perché ogni richiesta di pagina ora recupera dati. O viceversa: i dati non sembrano essere memorizzati nella cache, ma la pagina mostra ancora quelli vecchi.
Trap: nessuna cache di recupero, ma la pagina è statica
Se il percorso non utilizza API dinamiche (cookies(), headers(), searchParams, connection()), Next.js ne eseguirà il pre-rendering in next build. Il fetch non memorizzato nella cache verrà eseguito una volta in fase di compilazione e il risultato rimarrà nell'HTML per sempre. In modalità sviluppo tutto sembra dinamico, quindi il problema si manifesta solo in produzione.
Verifica - output next build: ○ significa percorso statico, ƒ significa dinamico.
Rendi esplicitamente dinamico il percorso:
// app/dashboard/page.tsx
import { connection } from "next/server";
export default async function Page() {
await connection(); // дальше всё выполняется на каждый запрос
const stats = await fetch("https://api.example.com/stats").then((r) => r.json());
return <Stats data={stats} />;
}O viceversa, aggiorna periodicamente il percorso statico tramite export const revalidate = 300 nel file di paging.
Memorizzazione nella cache del recupero con i tag
[[VB_1_CODICE]]
revalidate: 3600 - durata di riserva. Il meccanismo principale è l'invalidazione del tag al momento della modifica dei dati.
revalidateTag e revalidatePath
[[VB_2_CODICE]]
Differenza tra le funzioni:
revalidateTag(tag)contrassegna come obsolete tutte le voci della cache di dati con questo tag, indipendentemente dalle pagine su cui vengono utilizzate.revalidatePath(path)invalida un percorso specifico. Per un segmento dinamico, sono indicati il modello e il tipo:revalidatePath("/blog/[slug]", "page")- tutte le pagine di articoli,revalidatePath("/", "layout")- tutto in generale.
I tag sono più precisi: invalidi i dati, invece di indovinare in quali URL appaiono. revalidatePath è utile quando i dati non provengono da fetch (ad esempio, da un database senza wrapper).
Entrambe le funzioni funzionano in Azioni server e Gestori di route. Per un webhook da un CMS, crea un gestore di route con un controllo segreto che chiama revalidateTag.
unstable_cache per le query al database
fetch viene memorizzato nella cache tramite next, ma una richiesta a Postgres tramite ORM non lo è. C'è unstable_cache per questo:
[[VB_3_CODICE]]
Restrizioni: non puoi chiamare cookies() e headers() all'interno di una funzione - passa tutto ciò che dipende dalla richiesta come argomenti. Il risultato deve essere serializzato in JSON, quindi gli oggetti Date verranno restituiti come stringhe. Il prefisso unstable_ significa che l'API potrebbe cambiare. In Next.js 16, il modello di memorizzazione nella cache è stato nuovamente modificato (direttiva use cache e modifiche in revalidateTag), quindi controlla la documentazione per la tua versione durante l'aggiornamento.
Come capire cosa è memorizzato nella cache
- 1.Abilita la registrazione delle query in
next.config.ts:
[[VB_4_CODICE]]
La console del server visualizzerà le righe che indicano un successo o un mancato riscontro nella cache per ciascun fetch.
- 2.Per
next startself-hosted vedere l'intestazione della rispostax-nextjs-cache:HIT,STALEoMISSper le pagine dalla cache.
- 3.Controllare sulla build
next build && next start, non innext dev: in modalità sviluppo la cache si comporta diversamente.
Errori comuni
- Aspettarsi che
revalidateTagaggiorni i dati ricevuti senza tag. Il tag viene vincolato al momento della richiesta. - Invalidare dal componente client. Le funzioni di
next/cachefunzionano solo sul server. - Diverse istanze
next startdietro il bilanciatore. La cache predefinita si trova nel file system di ciascuna istanza erevalidateTagsu una non influirà sulle altre. È necessario uncacheHandlergenerico (ad esempio, su Redis). - Memorizza nella cache i dati personali sotto una chiave comune. Se la risposta dipende dall'utente, l'ID utente deve far parte della chiave ed è meglio non memorizzare affatto nella cache tali dati.
Quando la cache non è necessaria
È più semplice lasciare completamente dinamici i pannelli di amministrazione, gli account personali e le pagine con dati in tempo reale. Una cache è giustificata laddove gli stessi dati vengono letti da molti utenti più spesso di quanto non vengano modificati.