Rendering-Strategien (App Router)
Priorität: P0 (KRITISCH)
Wählen Sie die Rendering-Strategie basierend auf den Anforderungen an Datenaktualität und Skalierung aus. Siehe Strategie-Matrix.
Implementierungsrichtlinien
- SSG (Static Site Generation): Standard für den App Router. Verwenden Sie
generateStaticParams, um Routen zur Build-Zeit vorzurendern. Ausgelöst durchfetchmitcache: 'force-cache'. - SSR (Server-Side Rendering): Ausgelöst durch
cookies(),headers()oderfetchmitcache: 'no-store'. Für personalisierte oder hochaktuelle Daten verwenden. - ISR (Incremental Static Regeneration): Statische Inhalte nach dem Build aktualisieren.
revalidate(zeitbasiert) oderrevalidatePath/revalidateTag(on-demand) verwenden. - Streaming: Verwenden Sie
Suspense, um langsame asynchrone Komponenten zu umschließen und den initialen Seitenaufbau nicht zu blockieren. Verwenden Sieloading.tsxfür Route-level-Skeletons. - PPR (Partial Prerendering): Statische Shell mit dynamischen Bereichen in einer einzigen HTTP-Anfrage kombinieren. Aktivieren Sie
ppr: trueinnext.config.js. - Strategien: Wählen Sie basierend auf SEO (SSG/ISR) vs. Interaktivität (Client) vs. Personalisierung (SSR). Nutzen Sie
dynamicParams, um das Fallback-Verhalten für ungecachte Routen zu steuern. - Hydration: Vermeiden Sie Hydration Errors, indem Sie im initialen Rendering keine browser-spezifischen Werte (
window.innerWidth,Date.now()) verwenden. Nutzen Sie dasmounteduseEffect-Muster. - Edge Runtime: Verwenden Sie
runtime: 'edge'für latenzarme, global verteilte Ausführung, wenn keine vollständigen Node.js-APIs erforderlich sind.
Anti-Patterns
- Keine root-Awaits in
page.tsx: Umschließen Sie langsame Komponenten mit<Suspense>, um zu streamen. - Kein SSR für statische Inhalte: Verwenden Sie SSG oder ISR; reservieren Sie SSR für wirklich dynamische Daten.
- Kein
typeof windowim initialen Rendering: Verwenden SieuseEffect, um Hydrationsfehler zu vermeiden.