Caching in Next.js 15: ophalen zonder standaardcache, revalidateTag en instabiele_cache
Wat veranderde er toen we naar 15 verhuisden
In Next.js 14 werd fetch in servercomponenten standaard in de cache opgeslagen. In 15 was dit gedrag omgekeerd:
fetchwordt niet in de cache opgeslagen tenzij u explicietcache: 'force-cache'ofnext.revalidateopgeeft.- GET-handlers in Route Handlers worden standaard niet in de cache opgeslagen.
- Client Router Cache voor pagina's bevat niet langer segmenten van 30 seconden:
staleTimevoor dynamische pagina's is nul.
Een typisch verhaal na een update: de belasting van de API of database is toegenomen doordat bij elk paginaverzoek nu data wordt opgehaald. Of andersom: de gegevens lijken niet in de cache te zijn opgeslagen, maar de pagina toont nog steeds de oude.
Trap: geen ophaalcache, maar de pagina is statisch
Als de route geen dynamische API's gebruikt (cookies(), headers(), searchParams, connection()), zal Next.js deze vooraf weergeven op next build. Niet in de cache opgeslagen fetch wordt tijdens het bouwen één keer uitgevoerd en het resultaat blijft voor altijd in de HTML staan. In de ontwikkelingsmodus ziet alles er dynamisch uit, dus het probleem verschijnt alleen in de productie.
Controle - uitvoer next build: ○ betekent statische route, ƒ betekent dynamisch.
Maak de route expliciet dynamisch:
// 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} />;
}Of andersom, zorg ervoor dat de statische route periodiek wordt bijgewerkt via export const revalidate = 300 in het paginabestand.
Caching ophalen met tags
// lib/data/posts.ts
export async function getPosts() {
const res = await fetch("https://cms.example.com/posts", {
next: { revalidate: 3600, tags: ["posts"] },
});
if (!res.ok) throw new Error(`cms ${res.status}`);
return res.json() as Promise<Post[]>;
}
export async function getPost(slug: string) {
const res = await fetch(`https://cms.example.com/posts/${slug}`, {
next: { revalidate: 3600, tags: ["posts", `post:${slug}`] },
});
if (res.status === 404) return null;
return res.json() as Promise<Post>;
}revalidate: 3600 - reservelevensduur. Het belangrijkste mechanisme is het ongeldig verklaren van tags op het moment dat gegevens worden gewijzigd.
revalidateTag en revalidatePath
// app/admin/posts/actions.ts
"use server";
import { revalidatePath, revalidateTag } from "next/cache";
export async function publishPost(slug: string) {
await requireEditor(); // проверка прав — первой строкой
await cms.publish(slug);
revalidateTag(`post:${slug}`); // точечно: одна статья
revalidateTag("posts"); // списки, где она может быть
revalidatePath("/sitemap.xml");
}Verschil tussen functies:
revalidateTag(tag)markeert alle gegevenscachegegevens met deze tag als verouderd, ongeacht op welke pagina's ze worden gebruikt.revalidatePath(path)maakt een specifieke route ongeldig. Voor een dynamisch segment worden de sjabloon en het type aangegeven:revalidatePath("/blog/[slug]", "page")- alle pagina's met artikelen,revalidatePath("/", "layout")- alles in het algemeen.
Tags zijn nauwkeuriger: u maakt de gegevens ongeldig, in plaats van te raden op welke URL's deze voorkomen. revalidatePath is handig als de gegevens niet via fetch binnenkomen (bijvoorbeeld vanuit een database zonder wrapper).
Beide functies werken in Serveracties en Routehandlers. Voor een webhook vanuit een CMS maakt u een Route Handler met een geheime controle die revalidateTag aanroept.
onstabiele_cache voor zoekopdrachten naar de database
fetch wordt in de cache opgeslagen via next, maar een verzoek aan Postgres via ORM niet. Er is unstable_cache voor:
// lib/data/stats.ts
import { unstable_cache } from "next/cache";
import { db } from "@/lib/db";
export const getCategoryCounts = unstable_cache(
async (locale: string) => {
const { rows } = await db.query(
"SELECT category, count(*)::int AS n FROM threads WHERE locale = $1 GROUP BY category",
[locale]
);
return rows;
},
["category-counts"], // часть ключа; аргументы добавляются автоматически
{ revalidate: 600, tags: ["threads"] }
);Beperkingen: je kunt cookies() en headers() niet aanroepen binnen een functie - geef alles wat afhankelijk is van het verzoek door als argumenten. Het resultaat moet worden geserialiseerd naar JSON, zodat de Date-objecten als tekenreeksen worden geretourneerd. Het voorvoegsel unstable_ betekent dat de API kan veranderen. In Next.js 16 is het cachingmodel opnieuw gewijzigd (use cache richtlijn en wijzigingen in revalidateTag), dus controleer de documentatie voor uw versie wanneer u een upgrade uitvoert.
Hoe te begrijpen wat er in de cache wordt opgeslagen
- 1.Schakel het loggen van zoekopdrachten in
next.config.tsin:
const nextConfig = { logging: { fetches: { fullUrl: true } } };
export default nextConfig;De serverconsole geeft regels weer die een cache-hit of miss aangeven voor elke fetch.
- 2.Voor zelf-gehoste
next start, zie de antwoordheaderx-nextjs-cache:HIT,STALEofMISSvoor pagina's uit de cache.
- 3.Controleer de
next build && next startbuild, niet innext dev: in de ontwikkelingsmodus gedraagt de cache zich anders.
Veelgemaakte fouten
- Verwacht dat
revalidateTaggegevens bijwerkt die zijn ontvangen zonder tag. De tag is gebonden op het moment van de aanvraag. - Ongeldig maken vanuit de clientcomponent. Functies van
next/cachewerken alleen op de server. - Verschillende instanties
next startachter de balancer. De standaardcache bevindt zich in het bestandssysteem van elke instantie, enrevalidateTagop de ene heeft geen invloed op de andere. Je hebt een generiekecacheHandlernodig (bijvoorbeeld op Redis). - Cache persoonlijke gegevens onder een gemeenschappelijke sleutel. Als het antwoord afhangt van de gebruiker, moet de gebruikers-ID deel uitmaken van de sleutel en is het beter om dergelijke gegevens helemaal niet in de cache op te slaan.
Wanneer de cache niet nodig is
Het is gemakkelijker om beheerderspanelen, persoonlijke accounts en pagina's met realtime gegevens volledig dynamisch te laten. Een cache is gerechtvaardigd als dezelfde gegevens vaker door veel gebruikers worden gelezen dan gewijzigd.