Correction des erreurs 502 Bad Gateway sur Nginx : Guide étape par étape

L'erreur 502 Bad Gateway est l'un des problèmes les plus frustrants lors de la gestion d'un serveur web Nginx. Elle indique généralement que votre serveur Nginx agit comme une passerelle ou un proxy et qu'il a reçu une réponse invalide du serveur en amont (upstream).

Causes courantes

1. Service en amont arrêté : L'application (PHP-FPM, Node.js, Python, etc.) n'est pas en cours d'exécution.
2. Problèmes de socket : Le chemin vers le socket Unix est incorrect ou les permissions sont mal configurées.
3. Configuration de proxy incorrecte : Les directives proxy_pass pointent vers une adresse ou un port erroné.
4. Surcharge du serveur : Le serveur en amont est surchargé et ne répond pas à temps.

Étapes de dépannage

1. Vérifiez l'état de votre service en amont

Assurez-vous que votre application est bien active. Par exemple, pour PHP-FPM :

sudo systemctl status php8.2-fpm

2. Examinez les journaux d'erreurs Nginx

C'est l'étape la plus importante. Consultez les logs pour identifier la cause exacte :

sudo tail -f /var/log/nginx/error.log

3. Vérifiez la configuration du proxy

Assurez-vous que votre bloc location pointe vers le bon port ou socket :

location / {
    proxy_pass http://127.0.0.1:3000;
}

4. Redémarrez les services

Parfois, un simple redémarrage suffit à résoudre les problèmes de connexion persistants :

sudo systemctl restart php8.2-fpm
sudo systemctl restart nginx

En suivant ces étapes, vous devriez être en mesure d'identifier et de corriger rapidement la source de votre erreur 502.