¿Qué es el error 502?

También llamado: 502 Bad Gateway

Definición

El error 502 (Bad Gateway) aparece cuando un servidor intermedio, como un proxy, una CDN o Nginx, no recibe una respuesta válida del servidor que hay detrás. Suele significar que la aplicación está caída o se ha bloqueado.

Muchas webs tienen varias capas: una CDN, un proxy inverso como Nginx y, detrás, la aplicación (PHP-FPM, Node, Python…). El 502 lo genera la capa intermedia cuando la de detrás no contesta bien: la conexión se rechaza, se corta o la respuesta no tiene sentido.

Ejemplo

En el log de errores de Nginx:

connect() to unix:/run/php/php8.3-fpm.sock failed (111: Connection refused)
while connecting to upstream, client: 198.51.100.77, upstream: "fastcgi://unix:/run/php/php8.3-fpm.sock"

Aquí Nginx no puede hablar con PHP-FPM. Comprobar y reiniciar el servicio:

$ systemctl status php8.3-fpm
$ sudo systemctl restart php8.3-fpm

Causas más frecuentes

El proceso de la aplicación está caído: PHP-FPM, Node, Gunicorn… Se ha detenido o ha fallado al arrancar.
Configuración que apunta a donde no es: un puerto o un socket que cambió tras actualizar la versión de PHP.
La aplicación se queda sin memoria y el sistema mata el proceso.
Un cortafuegos entre el proxy y el servidor de destino.

502, 503 y 504

502: el de detrás responde mal o no acepta la conexión.
503: el servicio no está disponible (sobrecarga o mantenimiento).
504: el de detrás acepta la conexión pero tarda demasiado en contestar.

¿Tienes un producto o servicio relacionado con Error 502? Anúnciate en este término.

Términos relacionados

Categorías: Web Backend