HTTP 502 Bad Gateway
La queja del intermediario: un proxy o CDN preguntó al servidor real y recibió basura — o nada — de vuelta.
Qué significa HTTP 502
HTTP 502 Bad Gateway proviene de un intermediario — nginx, un balanceador de carga, Cloudflare — que reenvió tu solicitud a un servidor de origen y recibió una respuesta inválida: una conexión rechazada, un fallo a mitad de respuesta, o bytes que no se parsean como HTTP.
El culpable señalado casi nunca es el proxy en sí; es el servidor de aplicaciones detrás de él que está caído, sobrecargado o inalcanzable.
Causas comunes de los errores 502
- El servidor de aplicaciones (PHP-FPM, Node, gunicorn, etc.) se cayó o no se está ejecutando.
- El proxy apunta al puerto/socket equivocado, o un firewall bloquea la conexión al origen.
- La respuesta del origen excedió los búferes o agotó el tiempo a mitad de transferencia.
- Un despliegue reinició los backends mientras fluía tráfico.
- Con CDN como Cloudflare: el servidor de origen está caído mientras el edge está bien.
Cómo solucionarlo como visitante
- Recarga después de un minuto — los 502 durante despliegues se resuelven solos.
- Revisa la página de estado del servicio si sigue ocurriendo.
Cómo solucionarlo como desarrollador
- Comprueba si el proceso de origen está vivo y escuchando en la dirección que el proxy espera.
- Lee el registro de errores del proxy — nginx dice exactamente por qué (connect() failed, upstream prematurely closed, etc.).
- Verifica puertos, rutas de socket unix y reglas de firewall entre el proxy y la aplicación.
- Añade comprobaciones de salud para que el balanceador de carga deje de enrutar a instancias caídas.
Ejemplo de respuesta
HTTP/1.1 502 Bad Gateway Server: nginx Content-Type: text/html <html><body><h1>502 Bad Gateway</h1></body></html>
Preguntas frecuentes
¿Cuál es la diferencia entre 502 y 504?
502 significa que el origen respondió con algo inválido (o rechazó la conexión); 504 significa que no respondió en absoluto dentro del tiempo límite.
¿Por qué Cloudflare muestra 502?
El edge de Cloudflare no pudo obtener una respuesta válida de tu servidor de origen — el origen está caído, es inalcanzable o devuelve respuestas malformadas.
¿Es temporal un 502?
Normalmente sí — los despliegues y reinicios causan 502 breves. Los 502 persistentes significan que el backend está realmente caído o mal configurado.