Qué significa
Un gateway o proxy recibió una respuesta no válida del servidor upstream al que reenvió la petición.
Causas habituales
- El servidor de la app se cayó o no está escuchando (puerto o socket equivocado)
- El upstream cerró la conexión o envió cabeceras mal formadas
- Reinicio de procesos PHP-FPM, Gunicorn o Node
Cómo solucionarlo
Si eres el cliente o visitante
Reintenta en un momento; suele ser temporal. Si persiste, el backend del sitio está caído.
Si administras el sitio o la API
Comprueba que el proceso upstream esté en marcha y escuchando en la dirección que usa el proxy, y lee el registro de errores del proxy para ver el error exacto.
Respuesta de ejemplo
HTTP/1.1
HTTP/1.1 502 Bad Gateway
Date: Tue, 07 Oct 2025 09:30:00 GMT
Server: nginx
Content-Type: text/html
Content-Length: 0Especificación
Preguntas frecuentes
› ¿Cómo arreglo un 502 Bad Gateway en nginx?
Revisa el upstream (si la app está en marcha y la dirección/socket de proxy_pass es correcta) y el registro de errores de nginx; reinicia el servidor de la app si se cayó.
› ¿502 o 504?
502: el upstream respondió basura o cerró la conexión. 504: el upstream no respondió a tiempo.