Caching-Architektur
Priorität: P1 (HOCH)
Next.js verfügt über 4 verschiedene Caching-Ebenen. Ihr Verständnis verhindert Fehler durch veraltete Daten.
Implementierungsrichtlinien
- Next.js 15+ Standard: Verwende
fetchmitrevalidate: numberodercache: 'force-cache'für API-Aufrufe. Verwendeunstable_cacheoder die neue'use cache'(experimentell) für benutzerdefinierte Datenspeicher. - Ebenen: Unterscheide zwischen Data Cache (persistent über Anfragen hinweg) und Request Memoization (React-Lebenszyklus spezifisch). Verwende
cache()aus React, um Fetch-Aufrufe innerhalb eines einzelnen Render-Durchlaufs zu deduplizieren. - Invalidierung: Verwende
revalidatePath('/')nach Mutationen oderrevalidateTag('tag-name')für granulare Cache-Bereinigung. - Client-Cache: Verstehe den Router Cache (im Arbeitsspeicher des Clients) mit einer Lebensdauer von 30 Sekunden bis Minuten. Leere ihn mit
router.refresh(). - Statische Assets: Nutze
generateStaticParamszum Vorrendern statischer Routen zur Build-Zeit. Verwende ISR (Incremental Static Regeneration) für Inhalte, die sich periodisch aktualisieren. - Streaming: Kombiniere
Suspensemitfetch-Auslösern, um zu verhindern, dass langsame Daten das gesamte Seiten-Rendering blockieren. - Next.js 16+: Bevorzuge
'use cache'undcacheLife()gegenüberrevalidate: number, wo verfügbar, für deterministisches Caching.
| Ebene | Wo | Steuerung |
|---|---|---|
| Request Memoization | Server | React cache() |
| Data Cache | Server | 'use cache', revalidateTag |
| Full Route Cache | Server | Static Prerendering |
| Router Cache | Client | router.refresh() |
Implementierungsdetails
Siehe Cache-Komponenten & PPR für detaillierte Schlüsselgenerierung, Closure-Einschränkungen und Invalidierungsstrategien.
Anti-Patterns
- Kein
unstable_cachein Next.js 16+: Verwende stattdessen die'use cache'-Direktive mitcacheLife(). - Kein
router.refresh()für Serverdaten: BevorzugerevalidateTag()für gezielte Cache-Bereinigung. - Kein Caching benutzerspezifischer Daten auf Routenebene: Ummantle persönliche Daten mit
<Suspense>und'use cache'. - Kein langlebiger Cache ohne Tags: Weise
cacheTag()für feingranulare Invalidierungskontrolle zu.