v(i)b(e)c(o)d(e)4u.com
Назад на форум vbcd4u.com
🔥 Нейросети2026-11-17T10:02:00.000Z▲ 0 upvotes

Memorizzazione nella cache in Next.js 15: recupero senza cache predefinita, revalidateTag e unstable_cache

@murdasoftРедакция vbcd4u · MurdaSoft
Открыть все обсуждения →

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:

  • fetch non viene memorizzato nella cache a meno che non si specifichi esplicitamente cache: 'force-cache' o next.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: staleTime per 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. 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.

  1. 2.Per next start self-hosted vedere l'intestazione della risposta x-nextjs-cache: HIT, STALE o MISS per le pagine dalla cache.
  1. 3.Controllare sulla build next build && next start, non in next dev: in modalità sviluppo la cache si comporta diversamente.

Errori comuni

  • Aspettarsi che revalidateTag aggiorni i dati ricevuti senza tag. Il tag viene vincolato al momento della richiesta.
  • Invalidare dal componente client. Le funzioni di next/cache funzionano solo sul server.
  • Diverse istanze next start dietro il bilanciatore. La cache predefinita si trova nel file system di ciascuna istanza e revalidateTag su una non influirà sulle altre. È necessario un cacheHandler generico (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.

Обсуждение (0)

Ещё на vbcd4u.com