Erreurs du serveur
Erreur 502 Bad Gateway
Une erreur 502 est généralement affichée lorsqu’un processus PHP unique s’exécute pendant une durée supérieure aux valeurs max_execution_time
ou max_input_time
définies dans la configuration de PHP, ce qui entraine un dépassement du délai d’exécution de PHP.
Vous devez d’abord déterminer la cause de l’erreur 502 pour trouver une solution. Dans certains cas, vous devrez peut-être augmenter les ressources, ajuster les réglages ou trouver un autre flux de travail.
Par exemple, si l’erreur survient lors d’une tentative d’importation, il est recommandé d’exécuter l’importation directement sur le conteneur en utilisant WP-CLI ou un script PHP ou Bash local.
Trouver et résoudre une erreur 502 Bad Gateway
Il peut y avoir un certain nombre d’endroits à vérifier et de solutions à essayer lorsque vous recherchez la source d’une erreur 502 Bad Gateway.
CDN tiers
Si votre site utilise un CDN tiers en plus de l’intégration Cloudflare de Kinsta, désactivez ou contournez temporairement ce CDN. Si le problème est résolu, vous devrez ajuster les réglages ou vérifier avec le support de votre fournisseur CDN si un pare-feu ou une autre fonctionnalité interfère avec votre site.
Journal d’erreurs
Consultez le fichier error.log de votre site dans MyKinsta (ou téléchargez-le via SFTP) pour identifier la source de l’erreur. Si rien d’évident ne ressort, il peut être utile d’activer WP-DEBUG
.
Statistiques MyKinsta
Consultez le rapport de ventilation des erreurs 500 dans les statistiques MyKinsta pour voir le nombre total d’erreurs 502 et quand elles se produisent.
Plugins et thèmes
Désactivez toutes les extensions et adoptez un thème par défaut. Si le problème est résolu, réactivez les extensions une par une et réactivez votre thème jusqu’à ce que le problème se reproduise. Une fois que vous avez déterminé l’extension ou le thème à l’origine du problème, envoyez une copie de l’erreur au développeur de l’extension ou du thème afin qu’il puisse vous aider à résoudre le problème.
Augmentation du délai d’attente de PHP
Chez Kinsta, les valeurs max_execution_time
ou max_input_time
sont fixées par défaut à 300 secondes (5 minutes). Les valeurs maximales du délai d’attente PHP disponibles sont basées sur votre plan d’hébergement actuel. Si vous avez besoin d’augmenter ces valeurs, démarrez une nouvelle discussion avec notre équipe de support.
Augmenter le nombre de workers PHP
Dans certains cas, il peut être nécessaire d’augmenter le nombre de workers PHP. Si vous n’êtes pas sûr, notre équipe de support peut vous aider à déterminer si l’ajout de workers PHP est nécessaire pour votre site.
Erreur 504 Gateway Timeout
Une erreur 504 est généralement affichée lorsque la connexion entre votre navigateur et le serveur web est maintenue ouverte pendant plus de 180 secondes, ce qui entraine un dépassement de délai HTTP.
Lorsque plusieurs requêtes arrivent en même temps ou presque, il se peut que certaines d’entre elles doivent attendre avant d’être traitées. Ainsi, même si le serveur traite des requêtes, si chacune d’entre elles prend beaucoup de temps à être traitée, un grand nombre de requêtes peut s’empiler. Lorsque la file d’attente devient trop importante et que les processus attendent trop longtemps, le serveur ne tient pas compte des requêtes les plus anciennes, ce qui entraine le renvoi d’une erreur 504 de passerelle.
Comme pour la plupart des dépannages, la première étape consiste à déterminer la cause première de l’erreur.
Recherche et résolution d’une erreur de délai d’attente de passerelle 504
Erreurs au cours de l’importation
Si l’erreur se produit pendant une importation, essayez d’exécuter l’importation directement sur le serveur en utilisant WP-CLI ou un script PHP ou Bash local. Cela contournera entièrement la connexion HTTP, vous permettant de terminer l’importation sans erreur 504.
CDN tiers
Si votre site utilise un CDN tiers en plus de l’intégration Cloudflare de Kinsta, désactivez ou contournez temporairement ce CDN.
Vérifier le chemin de téléversement
Si vous voyez une erreur liée au chemin de fichier lorsque vous essayez de téléverser un fichier (par exemple en ajoutant et en téléverseant une image dans le contenu), il se peut que le chemin de téléversement soit incorrect. Ce problème survient le plus souvent juste après la migration d’un site. En fonction de la configuration de votre ancien hébergeur, le chemin de téléversement peut avoir été personnalisé. Vous pouvez le voir dans la table wp_options
ou dans le tableau de bord de WordPress (Réglages > Médias > Téléversement de fichiers).
Dans le tableau de bord de WordPress, si vous voyez des options intitulées Stocker les téléversements dans ce dossier et Chemin d’accès complet aux fichiers, c’est qu’elles ont été personnalisées. Les données correspondantes dans la base de données se trouvent sur le site wp_options table
dans les options upload_path
et upload_url_path
.
Vous pouvez supprimer tout ce qui se trouve dans ces champs (soit dans le tableau de bord de WordPress, soit dans la base de données) pour les ramener à leurs valeurs par défaut.
Taille des fichiers téléversés
Si vous voyez une erreur liée à la taille du fichier lorsque vous essayez de téléverser un fichier, vérifiez la taille du ou des fichiers que vous essayez de téléverser. Certains CDN limitent la taille des fichiers que vous pouvez téléverser. Si vous utilisez un CDN tiers, vérifiez la taille maximale de téléversement dans vos réglages de CDN et assurez-vous que vos téléversements sont inférieurs à la taille maximale. Ou, si votre site exige que la taille du fichier soit aussi importante, ajustez la taille maximale du téléversement sur votre CDN (si possible).
Base de données corrompue
Une base de données corrompue peut parfois être à l’origine d’erreurs 504. Si vous voyez des erreurs qui indiquent une base de données corrompue (par exemple, « Une ou plusieurs tables de la base de données sont indisponibles. La base de données doit être réparée » lorsque vous vous connectez au tableau de bord de WordPress), consultez notre guide sur la réparation d’une base de données corrompue.
Plugins et thèmes
Bien que cela soit moins courant, une extension ou un thème peut parfois être à l’origine d’une erreur 504. La meilleure façon de le vérifier est de désactiver toutes les extensions et d’utiliser un thème par défaut. Si le problème est résolu, réactivez les extensions une par une et réactivez votre thème jusqu’à ce que le problème se reproduise. Une fois que vous avez déterminé l’extension ou le thème en cause, envoyez une copie de l’erreur au développeur de l’extension ou du thème afin qu’il puisse vous aider à résoudre le problème.
Journal des erreurs
Consultez le fichier error.log de votre site dans MyKinsta (ou téléchargez-le via SFTP) pour déterminer la source de l’erreur. Si rien d’évident ne ressort, il peut être utile d’activer WP-DEBUG
.
Trafic et mise en cache
Vérifiez le rapport des visiteurs dans MyKinsta analytics pour voir si votre site connait un pic de trafic et/ou un grand nombre de requêtes non mises en cache. Ouvrir une discussion avec notre équipe de support peut être utile dans ce cas, afin que nous puissions vous aider à déterminer si les requêtes sont légitimes et si plus de ressources (comme des workers PHP) peuvent être nécessaires.
Augmenter le nombre de workers PHP
Dans certains cas, il peut être nécessaire d’augmenter le nombre de workers PHP. Si vous n’êtes pas sûr, notre équipe de support peut vous aider à déterminer si l’ajout de workers PHP est nécessaire pour votre site.
Réduire le trafic
Si votre site connait un pic de trafic ou simplement une augmentation du trafic en général, et que l’augmentation des ressources n’est pas envisageable, une alternative pour éviter que trop de requêtes n’arrivent en même temps sur le serveur est d’implémenter un système de file d’attente comme l’un des suivants :