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, sur des sites inaccessibles au public grâce à l'authentification htaccess, ou à des plugins "Mode Maintenance" ou similaires. 
2. Les IPs de cette liste ne doivent pas être bloquées par votre serveur ou un plugin de sécurité.

   Le mode BFM (Bot Fight Mode) de Cloudflare peut empêcher le générateur du Critical Path CSS (CPCSS) d'accéder à votre site.
   Désactivez-le et vérifiez si le CPCSS est généré :

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é autorisées 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. 

L'utilisateur a bloqué les requêtes via HTTP

Les requêtes HTTP externes ont été bloquées sur votre site : 

• Vérifiez si vous avez cette ligne dans votre fichier wp-config.php :  define( 'WP_HTTP_BLOCK_EXTERNAL', true );
• Vérifiez si un plugin de sécurité bloque les requêtes HTTP externes
• Assurez-vous d'ajouter ces IPs à la liste des IPs autorisées : 109.234.160.58 et 51.83.15.135

Tâche non trouvée

• Il s'agit généralement d'une erreur temporaire. Veuillez réessayer la régénération dans quelques minutes.

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 à autoriser nos adresses 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

• Autoriser les adresses IPs de notre outil 109.234.160.58, 51.83.15.135 et 51.210.39.196 dans Cloudflare comme indiqué ici (ou tout autre service de 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

• 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

Timeout