Quelle redirection est prioritaire lorsque des règles Cloudflare Pages se chevauchent ?

L'équipe Citead, mis à jour le

En bref. Lorsque les chemins source sont identiques, Cloudflare Pages applique la règle _redirects placée le plus haut ; les règles statiques se placent avant les règles dynamiques, et Bulk Redirects s’exécute avant Pages.

Définition : La priorité des redirections détermine quelle règle s’applique lorsque plusieurs règles se chevauchent. Au 17 octobre 2026, la documentation de Cloudflare Pages indique que la règle placée le plus haut dans _redirects est prioritaire lorsque plusieurs règles ont le même chemin source, et demande de placer les redirections statiques avant les redirections dynamiques.

Points clés

  • La documentation sur les redirections de Cloudflare indique que la redirection placée le plus haut s’applique lorsque plusieurs règles ont le même chemin source. Une ressource correspondante ne prend pas le pas sur la redirection.
  • La documentation sur les en-têtes de Cloudflare donne la priorité aux redirections lorsqu’une requête correspond à la fois à une redirection et à une règle d’en-tête.
  • La documentation sur le routage des Functions de Cloudflare prévoit un paramètre exclude dans _routes.json, prioritaire sur include pour déterminer si les Functions s’exécutent.

Dans quel ordre placer les règles qui se chevauchent ?

Les consignes relatives au fichier donnent la priorité à la règle placée le plus haut lorsque des chemins source sont identiques et demandent de placer les redirections statiques avant les redirections dynamiques. Les règles statiques utilisent des chemins littéraux ; les règles dynamiques utilisent des motifs de correspondance, comme des caractères génériques ou des paramètres nommés (placeholders).

Ce fichier _redirects fourni à titre d’illustration respecte la syntaxe documentée :

/home / 301
/home /archive 302
/blog/* /posts/:splat

Pour /home, la première ligne sélectionne / avec le code de statut 301. Placer la deuxième ligne au-dessus sélectionne à la place la destination /archive avec le code de statut 302. Supprimer le doublon évite que le choix de cette destination dépende de l’ordre des lignes.

Le caractère générique *, appelé splat, capture le plus de caractères possible ; :splat insère la valeur capturée dans la destination. La règle du blog de cet exemple omet le code de statut et utilise donc la valeur par défaut documentée, 302. Les exceptions portant sur des chemins littéraux se placent au-dessus des règles dynamiques, conformément à la consigne d’ordre de Cloudflare.

Un fichier existant ou une règle d’en-tête peut-il prendre la priorité ?

Les consignes de correspondance des redirections de Cloudflare indiquent que les redirections s’appliquent même lorsqu’une ressource correspond à la requête entrante. Conserver un fichier à son ancien chemin laisse donc la redirection correspondante en vigueur.

La même documentation place le traitement des redirections avant celui des en-têtes. Une règle _headers correspondante ne peut pas prendre la priorité sur cette redirection. Par ailleurs, les règles de correspondance des en-têtes de Cloudflare combinent les en-têtes de plusieurs motifs correspondants. Le cumul des règles d’en-tête et la sélection des redirections suivent des règles distinctes dans la documentation.

Où interviennent les Bulk Redirects ?

Bulk Redirects est un dispositif distinct de redirection de Cloudflare, que la documentation de Pages recommande pour les ensembles de redirections qui dépassent les limites de _redirects. Elle place les Bulk Redirects avant le projet Pages en cas de doublons.

Cloudflare illustre ce fonctionnement par une redirection Bulk Redirect de abc.com vers xyz.com, suivie d’une règle Pages _redirects de xyz.com vers foo.com. La requête atteint finalement foo.com. L’ordre des lignes d’un fichier Pages ne régit donc qu’une partie d’une configuration qui utilise aussi Bulk Redirects ; la redirection Bulk Redirect exécutée en amont peut mener à une autre redirection à destination.

Que se passe-t-il lorsque Pages Functions traite la requête ?

Pages Functions exécute du code applicatif pour des routes désignées. La documentation sur les redirections de Cloudflare exclut du traitement de _redirects les requêtes prises en charge par les Functions, même si leur URL correspond à un motif de redirection. Elle demande d’implémenter ce comportement dans la Function appropriée ou d’exclure la route des Functions.

La documentation sur le routage de Cloudflare place _routes.json dans le répertoire de compilation et donne la priorité à exclude sur include. Son exemple exclut /build/* tout en incluant les autres chemins :

{
  "version": 1,
  "include": ["/*"],
  "exclude": ["/build/*"]
}

Cette exclusion concerne l’appel des Functions. L’ordre des redirections dans _redirects reste régi par les règles propres au fichier de redirection.

Termes associés

Questions fréquentes

La dernière redirection en doublon est-elle prioritaire ?

Les consignes relatives au fichier de Cloudflare sélectionnent la règle placée le plus haut lorsque plusieurs règles ont le même chemin source. Vous pouvez supprimer les doublons et placer les règles statiques avant les règles dynamiques lors de la révision du fichier.

Une règle de proxy s’enchaîne-t-elle avec une autre règle de proxy ?

Pour les règles de proxy utilisant le code de statut 200, la même documentation présente /a /b 200 suivi de /b /c 200. Une requête vers /a affiche /b ; elle ne poursuit pas vers /c au moyen de la deuxième règle de proxy.

Où placer le fichier de redirection ?

Vous placez _redirects, sans extension de fichier, dans le répertoire des ressources statiques du projet. La même documentation cite public/ et static/ comme répertoires courants des frameworks dont le contenu est copié dans le répertoire de sortie de la compilation.

Sources

  1. Cloudflare, « Redirects », mis à jour le 25 août 2026
  2. Cloudflare, « Headers », mis à jour le 25 août 2026
  3. Cloudflare, « Routing », mis à jour le 18 septembre 2026

Vérifiez comment une page se lit pour les moteurs de réponse. Ouvrir l’analyseur de score GEO

Testez une page et voyez quoi corriger en premier

L'analyse prend en général moins de 10 secondes et ne demande pas de compte.

400 000+ pages notées dans le benchmark public