Next.js
Cache Next.js 16 : afficher le contenu après publication du CMS
Vous publiez une correction dans votre CMS. La base contient le bon texte, l’administration confirme l’enregistrement, mais la page publique présente encore l’ancienne version. Relancer le serveur fait disparaître le problème, jusqu’à la prochaine publication. Cette situation indique souvent une politique de fraîcheur incomplète : l’écriture fonctionne, mais les lecteurs utilisent toujours une copie précédente.
Ce guide concerne Next.js 16 avec l’App Router. Il distingue les mécanismes à inspecter, puis propose une invalidation adaptée à un CMS. Les exemples ne supposent pas que toutes les requêtes sont cachées par défaut. Ils déclarent leur intention et utilisent les signatures actuelles à deux arguments de revalidateTag.
Identifier la copie qui contient encore l’ancien contenu
Commencez par lire la donnée depuis sa source, avec un outil autorisé. Si elle est déjà incorrecte, le cache public n’est pas responsable. Une publication peut avoir mis à jour un brouillon, un autre environnement ou un champ différent de celui affiché. Vérifiez l’identifiant, le statut et l’heure de publication avant toute purge.
Si la source est correcte, comparez une requête HTTP directe à la page et l’affichage d’un onglet déjà ouvert. Un nouvel accès correct avec un onglet ancien peut pointer vers un état client ou une navigation conservée. Une réponse HTTP elle-même ancienne oriente plutôt vers les couches serveur ou un intermédiaire réseau.
Dessinez le chemin effectif de votre application. Il n’est pas nécessaire que toutes ces couches existent dans chaque projet :
CMS ou base
-> cache de lecture Next.js
-> réponse de route éventuellement réutilisée
-> proxy ou CDN éventuel
-> navigateur et état de navigationUne invalidation à un niveau n’est pas une commande universelle qui vide tous les autres. Recharger la page peut contourner un état local sans régler le webhook défaillant. À l’inverse, purger un CDN ne corrige pas une lecture serveur conservée trop longtemps.
Déclarer explicitement les données mises en cache
Supposons une API éditoriale publique dont l’URL est configurée côté serveur. Nous choisissons une durée de secours et un tag commun pour les listes d’articles. Le contrat de réponse doit être validé dans le projet réel avant d’être utilisé par l’interface.
// lib/articles.ts
import 'server-only';
export async function readArticles(): Promise<unknown> {
const endpoint = process.env.CMS_PUBLIC_ARTICLES_URL;
if (!endpoint) throw new Error('Source éditoriale non configurée');
const response = await fetch(endpoint, {
cache: 'force-cache',
next: { tags: ['public-articles'], revalidate: 300 },
});
if (!response.ok) throw new Error('Lecture du CMS impossible');
return response.json();
}La durée de cinq minutes est un choix illustratif, pas un réglage universel. Elle constitue un filet de sécurité si l’événement de publication est perdu. Le tag permet une invalidation ciblée sans attendre cette échéance. Les options disponibles sont précisées dans la référence fetch de Next.js.
Pour un accès direct avec Prisma, ce code n’ajoute aucun cache : Prisma ne passe pas par ce fetch. Il faut inspecter l’éventuelle fonction de cache qui entoure la requête. Copier un exemple de webhook sans identifier la lecture réellement utilisée ne peut pas résoudre le problème.
Choisir entre fraîcheur immédiate et réponse rapide
Avec revalidateTag('public-articles', 'max'), la donnée est marquée comme périmée et une prochaine lecture peut recevoir la version précédente pendant son renouvellement. Avec { expire: 0 }, la prochaine lecture attend la revalidation au lieu de recevoir cette version périmée. L’appel ne reconstruit pas instantanément toutes les pages ; la documentation de revalidateTag précise ce déclenchement à la lecture.
Pour un blog personnel, accepter brièvement un ancien texte peut être raisonnable. Pour une correction sensible ou un retrait de contenu, la première réponse après publication peut devoir être fraîche. Écrivez cette exigence avant de choisir l’API : « publication réussie » doit avoir une signification compréhensible pour l’auteur.
Dans une Server Action où l’utilisateur doit immédiatement relire sa propre modification, updateTag offre ce comportement. Cette fonction est réservée aux Server Actions ; un webhook défini dans un Route Handler ne doit pas l’utiliser. L’ancien appel revalidateTag(tag) sans second argument est déprécié.
Protéger un webhook d’invalidation
Un endpoint public qui invalide arbitrairement n’importe quel tag peut provoquer une charge inutile. Le webhook doit authentifier son appelant, limiter sa portée et garder ses secrets hors des URL. Voici un exemple réduit : un jeton serveur autorise uniquement l’expiration des articles publics. Il ne reçoit ni contenu ni nom de tag depuis le client.
// app/api/editorial-refresh/route.ts
import { timingSafeEqual } from 'node:crypto';
import { revalidateTag } from 'next/cache';
export const runtime = 'nodejs';
export async function POST(request: Request) {
const secret = process.env.CMS_REFRESH_SECRET;
if (!secret) {
return Response.json({ error: 'Service indisponible' }, { status: 503 });
}
const supplied = Buffer.from(request.headers.get('authorization') ?? '');
const expected = Buffer.from(`Bearer ${secret}`);
if (supplied.length !== expected.length ||
!timingSafeEqual(supplied, expected)) {
return Response.json({ error: 'Accès refusé' }, { status: 401 });
}
revalidateTag('public-articles', { expire: 0 });
return Response.json({ invalidated: true });
}En production, utilisez HTTPS, un secret généré pour cet usage, une rotation possible et une limitation de fréquence à l’entrée. Si votre fournisseur de CMS propose une signature horodatée du corps, utilisez son protocole pour traiter également le rejeu. Le jeton simplifié ci-dessus ne prétend pas offrir cette protection supplémentaire.
Déclenchez l’événement après la validation durable de l’écriture. Si l’invalidation arrive avant la transaction, un lecteur peut recharger l’ancienne version et la conserver à nouveau. L’application doit aussi pouvoir réessayer après une erreur réseau sans dupliquer la publication : invalider plusieurs fois le même tag ne doit pas créer plusieurs articles.
Traiter les cas que la première démonstration oublie
Une publication modifie souvent plusieurs représentations : la page de détail, la liste du blog, les articles associés et le sitemap. Dessinez ces dépendances. Un tag commun est simple pour un petit site ; des tags par article deviennent utiles lorsque les lectures et le trafic le justifient. Trop de granularité peut rendre les oublis plus probables.
Les brouillons et les aperçus demandent une séparation stricte. Une réponse privée ne doit pas entrer dans un cache public commun. Vérifier l’authentification après avoir récupéré un fragment déjà partagé est trop tard si celui-ci contient des informations confidentielles. Gardez les chemins de prévisualisation identifiables et testez-les sans session.
La publication programmée présente un autre piège : le temps peut rendre un article public sans nouvelle écriture. Il faut alors une tâche planifiée, une revalidation périodique ou un filtrage temporel cohérent à la lecture. Un webhook déclenché uniquement au clic « enregistrer » ne couvre pas ce changement.
Vérifier la correction sans se fier au message de succès
Créez un article de test avec une phrase reconnaissable. Chargez sa liste et sa page, modifiez la phrase, puis publiez. Interrogez ensuite une nouvelle requête HTTP et un onglet déjà ouvert. Notez ce qui doit être immédiat et ce qui demande un rafraîchissement utilisateur. Une invalidation serveur n’envoie pas automatiquement une mise à jour à tous les navigateurs connectés.
Testez aussi un webhook refusé, un événement répété et une source momentanément indisponible. Le journal doit permettre de relier l’identifiant de publication à l’invalidation, sans stocker le secret. Une alerte utile indique quel contenu risque d’être ancien ; elle ne se limite pas à un code HTTP isolé.
Enfin, contrôlez le document rendu et sa canonical. Une page fraîche à une mauvaise URL reste un problème éditorial et SEO. Le guide de diagnostic d’une page Next.js non indexée complète cette vérification.
Questions fréquentes
Faut-il désactiver tous les caches pour un petit CMS ?
Cela simplifie certains comportements mais déplace chaque lecture vers la source. Définissez d’abord le trafic, la disponibilité attendue et le délai éditorial acceptable. Une politique simple et testée vaut mieux qu’une accumulation de purges improvisées.
Le cache explique-t-il une erreur d’hydratation ?
Parfois des données incohérentes y contribuent, mais les dates et les valeurs navigateur ont leurs propres causes. Utilisez un diagnostic d’hydratation ciblé avant de modifier la stratégie serveur.
Cette méthode s’applique-t-elle à WordPress headless ?
Oui, si les événements et la lecture de l’API sont reliés correctement. Le choix implique toutefois prévisualisation, médias et maintenance ; comparez ces contraintes dans le guide WordPress headless ou thème classique. Pour discuter d’une intégration concrète, les coordonnées sont disponibles dans la section contact.