use cache dans Next.js 16 : mettre en cache sans mélanger les données de vos utilisateurs
18 Nov 2026 | Développement Web et Mobile
Avec les Cache Components, Next.js 16 permet de mettre en cache une fonction, un composant ou une page entière avec une simple directive : 'use cache'. C'est puissant, mais la mise à jour de sécurité du 3 novembre l'a rappelé : un cache mal conçu peut servir les données d'un client à un autre. Voici les règles pour l'utiliser sereinement.
Le principe en 30 secondes
// app/lib/products.ts
import { cacheLife, cacheTag } from 'next/cache';
export async function getProducts(categoryId: string) {
'use cache';
cacheLife('hours');
cacheTag(`category-${categoryId}`);
const res = await fetch(`${process.env.API_URL}/categories/${categoryId}/products`);
return res.json();
}
Next.js calcule une clé de cache à partir de la fonction et de ses arguments (ici categoryId). Deux appels avec les mêmes arguments partagent le même résultat. cacheLife fixe la durée de vie ; cacheTag permet d'invalider précisément avec revalidateTag().

Règle n°1 : tout ce qui change le résultat doit être un argument
La clé ne contient que ce que Next.js voit. Si le résultat dépend d'un utilisateur, d'un client (tenant), d'une langue ou d'un rôle, cette information doit être passée explicitement en argument :
// À éviter : le résultat dépend d'une info que la clé ne voit pas clairement
export async function getDashboard() {
'use cache';
const tenant = await currentTenant(); // contexte implicite
return loadDashboard(tenant);
}
// Préférable : la dépendance est visible dans la clé
export async function getDashboard(tenantId: string) {
'use cache';
cacheTag(`tenant-${tenantId}`);
return loadDashboard(tenantId);
}
Règle n°2 : séparer le public et le privé
- Données publiques (catalogue, articles, pages marketing) : candidates idéales pour
'use cache'. - Données personnelles (panier, profil, tableau de bord) : en général, ne les mettez pas dans un cache partagé. Lisez-les à la requête, dans un composant dynamique enveloppé dans
<Suspense>, et mettez en cache seulement les briques publiques autour.
Ce découpage public/privé est le même que celui que nous recommandons côté Laravel dans notre article sur le cache applicatif avec Redis.
Règle n°3 : des arguments simples et sérialisables
Passez des chaînes et des nombres plutôt que des objets complexes ou des données binaires. L'une des failles de novembre venait justement d'arguments binaires différents produisant la même clé. Un identifiant texte est plus lisible, plus sûr et plus facile à déboguer.
Règle n°4 : ne pas mélanger les mécanismes
La faille la plus grave concernait une fonction use cache appelée à la fois directement et depuis l'ancien unstable_cache. Pendant une migration, choisissez un mécanisme par donnée et supprimez progressivement unstable_cache.
Règle n°5 : invalider avec des tags
// app/actions/products.ts
'use server';
import { revalidateTag } from 'next/cache';
export async function updateProduct(id: string, categoryId: string, data: FormData) {
await saveProduct(id, data);
revalidateTag(`category-${categoryId}`);
}
Des tags par entité (produit, catégorie, client) évitent de vider tout le cache, et garantissent que la donnée modifiée n'est plus servie périmée.
Règle n°6 : tester le cloisonnement
Ajoutez un test de bout en bout qui se connecte successivement avec deux comptes de deux clients différents et vérifie que chacun ne voit que ses données, y compris juste après un redémarrage (cache froid). Les outils comme Playwright s'y prêtent bien (voir notre guide Playwright).
Checklist
- ☐ Chaque
use cachereçoit en argument tout ce qui influence le résultat - ☐ Aucune donnée personnelle dans un cache partagé
- ☐ Arguments simples (chaînes, nombres)
- ☐ Plus de mélange
unstable_cache/use cache - ☐ Tags d'invalidation par entité
- ☐ Test de cloisonnement entre deux comptes
- ☐ Next.js à jour (16.4.5 minimum sur la branche 16)
Conclusion
'use cache' rend la performance accessible en une ligne, mais la responsabilité de la clé reste au développeur. Rendez chaque dépendance explicite, gardez le privé hors du cache partagé et testez le cloisonnement : vous profiterez de la vitesse sans risquer une fuite de données.
Commentaires (0)
Aucun commentaire pour le moment.
Laissez un commentaire