Architecture de mise en cache
Priorité : P1 (HAUTE)
Next.js possède 4 niveaux de mise en cache distincts. Les comprendre permet d'éviter les bugs de données obsolètes.
Directives d'implémentation
- Standard Next.js 15+ : Utilisez
fetchavecrevalidate: numberoucache: 'force-cache'pour les appels API. Utilisezunstable_cacheou le nouveau'use cache'(expérimental) pour les magasins de données personnalisés. - Couches : Distinguez entre le cache de données (persistant entre les requêtes) et la mémoïsation des requêtes (spécifique au cycle de vie de React). Utilisez
cache()de React pour dédupliquer les récupérations au sein d'un même rendu. - Invalidation : Utilisez
revalidatePath('/')après des mutations ourevalidateTag('tag-name')pour une purge granulaire du cache. - Cache client : Comprenez le cache routeur (en mémoire sur le client) et sa durée de vie de 30 s à quelques minutes. Effacez-le avec
router.refresh(). - Actifs statiques : Exploitez
generateStaticParamspour le pré-rendu de routes statiques au moment de la construction. Utilisez l'ISR (Régénération Statique Incrémentale) pour le contenu mis à jour périodiquement. - Streaming : Combinez
Suspenseavec des déclencheursfetchpour éviter que les données lentes ne bloquent le rendu de la page entière. - Next.js 16+ : Privilégiez
'use cache'etcacheLife()par rapport àrevalidate: numberlorsque c'est disponible pour une mise en cache déterministe.
| Couche | Où | Contrôle |
|---|---|---|
| Mémoïsation des requêtes | Serveur | cache() de React |
| Cache de données | Serveur | 'use cache', revalidateTag |
| Cache de route complète | Serveur | Pré-rendu statique |
| Cache routeur | Client | router.refresh() |
Détails d'implémentation
Voir Cache Components & PPR pour la génération détaillée de clés, les contraintes de fermeture et les stratégies d'invalidation.
Anti-patrons
- Pas de
unstable_cachedans Next.js 16+ : Utilisez la directive'use cache'aveccacheLife()à la place. - Pas de
router.refresh()pour les données serveur : PréférezrevalidateTag()pour une invalidation ciblée. - Pas de mise en cache de données spécifiques à l'utilisateur au niveau de la route : Enveloppez les données personnelles dans
<Suspense>avec'use cache'. - Pas de cache à longue durée de vie sans tags : Assignez
cacheTag()pour un contrôle d'invalidation fin.