Comprendre et résoudre les erreurs de génération du Critical Path CSS

Quelques exigences de base pour que l'outil de génération fonctionne :

  1. Votre site doit être public et accessible pour que ça fonctionne, ça ne fonctionnera donc pas en local. 
  2. L' IP de l’outil ne doivent pas être bloquée par votre serveur ou un plugin de sécurité : 
    167.114.226.142 
  3. WP-cron ou une réelle tâche CRON serveur doit pouvoir tourner.

Lent ou pas de progression du tout

Si la génération semble fonctionner très lentement, c'est-à-dire qu'il faut beaucoup de temps pour mettre à jour l'indicateur de progression, il est probable que notre outil soit temporairement surchargé. Dans ces cas, il est préférable de réessayer dans quelques heures lorsque la charge sera moindre.

Notifications d'erreurs

S'il n'est pas possible pour notre outil de générer le Critical Path CSS pour n'importe quel type de contenu sur votre site, vous verrez unnotification d'erreur avec ses détails.

Certaines erreurs peuvent être temporaires, il vaut donc la peine d'essayer à nouveau la génération. Si les problèmes persistent, veuillez procéder au dépannage ci-dessous.

Si vous obtenez un message d'erreur sur chaque type de contenu (voir la capture d'écran ci-dessous comme exemple), c'est probablement que notre outil est bloqué par votre site. Veuillez vous assurer que votre site est accessible au public et que nos adresses IP ont bien été mises sur liste blanche par votre plugin de sécurité et/ou votre pare-feu.

Trouver l'URL d'accès par type de contenu

Notre outil accède à l'URL la plus récente pour chaque type de contenu de votre site. Si vous voyez une erreur pour un type de contenu spécifique, vous pouvez trouver à quelle URL spécifique l’outil tente d'accéder :

  • Installez et activez ce plugin d’aide : WP Rocket | CPCSS Debug Helper
  • Allez à : Réglages > CPCSS Helper
  • Vous y verrez l'URL à laquelle nous accédons pour chaque type de contenu.
  • Visitez les URLs problématiques pour vérifier si elles sont valides et accessibles

Code de réponse invalide

Notre outil externe envoie une requête à une page de votre site. S'il ne reçoit pas une réponse 200 “OK”, vous verrez une erreur dans la réponse.

Les raisons les plus communes sont :

  • L'URL n’est pas publiquement accessible, par exemple elle donne une 404
  • Une couche de sécurité sur votre site en bloque l'accès, ce qui entraîne souvent une erreur 400 ou 403. 

URL inaccessible

Cet notification d'erreur affichera les URLs spécifiques auxquelles l'outil ne peut pas accéder.

  • Visitez l'URL dans votre navigateur pour vous assurer qu'elle est accessible.
    • Si c'est le cas, il est probable qu'elle soit bloquée par un pare-feu ou un plugin de sécurité, veillez alors à whitelister nos IPs.
  • Si l'URL renvoie une erreur 404, ou toute autre erreur l'empêchant de s'afficher dans votre navigateur, cela signifie que notre outil ne pourra pas non plus y accéder.
    • Corrigez le problème avec cette page et essayez à nouveau la génération.
  • Si c'est pour un post type qui n'a pas été publié, cela ne fonctionnera pas. Certains post types ne sont pas conçus pour être visibles sur votre site Web. Par exemple, les post types qui gèrent les liens d'affiliation. Un post type peut être utilisé pour gérer chaque lien, mais ils ne sont pas visibles comme une page puisqu'ils redirigent ailleurs.

Aucune feuille de style valide n'est disponible

Vous verrez ce message si :

  • Il n'y a pas de feuilles de style ajoutées avec les balises <link>
  • Les feuilles de style liées sont vides
  • Il n'y a que du CSS inline sur votre site. L'outil n'utilise pas le CSS inline existant lors de la génération du Critical Path car cela pourrait entraîner une duplication du CSS.

Les styles contiennent une ou plusieurs erreurs

  • Une des feuilles de style récupérées n'est pas valide, ce qui empêche la génération du Critical CSS
  • Vérifiez que vos feuilles de style sont valides et accessibles. 

La protection CloudFlare empêche le service d'accéder au site Web

  • Mettre en liste blanche l'adresse IP de notre outil 167.114.226.142  dans Cloudflare comme indiqué ici  (ou tout autre service pare-feu similaire)

Une erreur empêche le générateur de récupérer son contenu

Parfois cette erreur peut être temporaire, essayez à nouveau.

Si l'erreur persiste, elle peut être liée à un délai d’attente (timeout) sur la page :

  • Il y a un timeout de 30 secondes pour des demandes de fichiers spécifiques.
  • Il y a un timeout d'une minute sur l'ensemble de la page.

Erreur SSL

Le certificat SSL du site Web n'est pas valide et notre service ne peut donc pas y accéder.

Connexion refusée

Les raisons les plus communes sont :
  • Le port (80 ou 443) n'est pas ouvert sur le client.
  • Le port (80 ou 443) est ouvert sur le serveur, mais son backlog de connexions en attente est plein.
  • Un pare-feu bloque l'accès.

Trop de redirections

S'il y a plus de 2 redirections lors de l'accès à une page donnée, la connexion est interrompue pour éviter les loops infinies.

Timeout

Si la durée entre la requête et le premier octet (TTFB "Time To First Byte") dépasse 20 secondes, la connexion sera fermée.

Impossible d'accéder à l'url suivante

Notre outil n'a pas pu accéder à la page demandée. Attendez quelques minutes, puis réessayez la génération.

Impossible de générer le Critical CSS. Le service peut être surchargé. Veuillez réessayer plus tard.

Lorsque plusieurs timeouts se succèdent, cela peut provoquer une surcharge de la file d'attente et faire planter notre générateur. Lorsque cela se produit, la file d'attente est purgée. Les sites Web qui étaient dans la file d'attente reçoivent cette erreur. Recommencez la régénération dans quelques heures lorsque la charge sera moindre.

Cela a-t-il répondu à votre question ? Merci pour votre retour :) Une erreur est survenue lors de l’envoi de votre retour. Veuillez réessayer plus tard.