L'erreur 502 Bad Gateway avec Nginx signifie que le reverse proxy n'arrive pas à obtenir une réponse valide du backend, généralement PHP-FPM. C'est un problème de communication entre les deux services.
Les causes sont variées : PHP-FPM crash, timeout, socket mal configuré, ou ressources épuisées. Ce guide vous aide à identifier la source exacte du problème.
Causes Principales
- PHP-FPM down : Le service PHP-FPM est arrêté ou a crash. Aucun worker disponible pour traiter les requêtes.
- Socket inexistant : Nginx essaie de se connecter à un socket Unix qui n'existe pas ou a les mauvaises permissions.
- Timeout upstream : PHP-FPM met trop de temps à répondre et Nginx abandonne.
- Workers épuisés : Tous les workers PHP-FPM sont occupés, les nouvelles requêtes sont rejetées.
Diagnostic
- Statut PHP-FPM : Vérifiez que PHP-FPM est actif : systemctl status php-fpm.
- Logs Nginx : Consultez /var/log/nginx/error.log pour le message exact (upstream, timeout, connection refused).
- Socket/Port : Vérifiez que le socket ou port configuré dans Nginx correspond à PHP-FPM.
Solutions
- Redémarrer PHP-FPM : systemctl restart php-fpm pour relancer le service.
- Augmenter les workers : Ajustez pm.max_children dans la config PHP-FPM selon la mémoire disponible.
- Augmenter les timeouts : Configurez fastcgi_read_timeout dans Nginx si les scripts légitimes sont lents.
Questions Fréquentes
Comment voir si PHP-FPM est surchargé ?
Activez pm.status_path dans PHP-FPM pour voir les workers actifs/idle. Si tout est "active", vous manquez de workers.
Socket ou TCP, lequel est mieux ?
Socket Unix est plus rapide sur le même serveur. TCP est nécessaire si PHP-FPM est sur un serveur différent.
Pourquoi PHP-FPM crash silencieusement ?
Souvent à cause d'un dépassement mémoire. Vérifiez memory_limit PHP et la mémoire système. Consultez les logs PHP-FPM.
MoniTao détecte-t-il les erreurs 502 ?
Oui, MoniTao surveille le code HTTP et vous alerte immédiatement sur les erreurs 5xx incluant 502.
Prêt à dormir sur vos deux oreilles ?
Commencez gratuitement, sans carte bancaire.