Error 502 Bad Gateway: qué significa y cómo arreglarlo

502 Bad Gateway significa que un servidor que actúa como gateway o proxy recibió una respuesta no válida del servidor que tiene detrás. El error se produce entre dos servidores, así que no viene del navegador ni del dispositivo del visitante. [1] [2]

Esta guía tiene dos partes. Si eres visitante, la sección corta de abajo indica qué puedes probar. Si gestionas la web, la sección de solución te ayuda a encontrar qué salto devolvió el 502, a leer la línea del log que indica la causa y a aplicar la solución y evitar que vuelva a pasar.

¿Qué significa 502 Bad Gateway?

Una petición a un sitio web suele pasar por varios saltos:

navegador → CDN o proxy → servidor web → aplicación

Cada salto reenvía la petición al siguiente. Si el salto que hay detrás de un proxy devuelve una respuesta que el proxy no puede usar, el proxy responde con 502. El código no dice qué salto ha fallado. En nginx, el 502 también aparece cuando el upstream rechaza la conexión, la reinicia o la cierra antes de tiempo, así que el código solo indica que el enlace que hay detrás del proxy se ha roto.

Hay dos cosas que un 502 no es. No es un aviso de que el visitante ha enviado una petición incorrecta. Tampoco es un timeout. Un upstream lento devuelve otro código, que se explica en la siguiente sección.

502 vs 503 vs 504

Tres códigos cubren la mayoría de fallos del lado del servidor entre saltos. Apuntan a causas distintas, así que lee el código antes de empezar a investigar.

Un 504 es un fallo de tiempos. El upstream respondió demasiado tarde, no de forma incorrecta. En nginx, los timeouts de lectura por defecto de proxy y FastCGI son de 60 segundos [4] [5].

Si ves un 502 como visitante

No puedes arreglar el servidor, pero sí descartar que el problema esté en tu lado y avisar.

• Espera un minuto y recarga la página. Un reinicio o un despliegue en el servidor puede hacer que el error desaparezca solo.
• Prueba otro navegador o otra red, como los datos móviles. Si el sitio carga ahí, el problema es local a tu conexión.
• Consulta la página de estado del sitio, si tiene una.
• Anota la hora y la dirección exacta que abriste. El administrador del sitio las necesita para encontrar la línea del log correspondiente.

Lo habitual es que la solución esté en el servidor, así que solo el administrador del sitio puede hacer que el error desaparezca. Si el sitio es tuyo, sigue los pasos de abajo.

Cómo solucionar un 502 Bad Gateway en tu servidor

Trabaja de fuera hacia dentro. Cada paso descarta un salto antes de pasar al siguiente.

curl -I "https://www.example.com/"
curl -I --resolve www.example.com:443:203.0.113.10 "https://www.example.com/"

sudo tail -n 50 /var/log/nginx/error.log

sudo systemctl status php8.3-fpm
sudo ss -lxp | grep php

pm2 status
sudo ss -ltnp | grep 3000

sudo systemctl status gunicorn
sudo ss -ltnp | grep 8000

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

location ~ \.php$ {
    fastcgi_pass unix:/run/php/php8.3-fpm.sock;
}

sudo nginx -t && sudo systemctl reload nginx

sudo dmesg -T | grep -i -E "out of memory|killed process"
free -h

location / {
    proxy_pass http://127.0.0.1:3000;
    proxy_buffer_size 16k;
    proxy_buffers 8 16k;
}

sudo ufw status verbose

502 detrás de Cloudflare o Citadel

El cuerpo de la página indica qué lado ha generado el error. Cloudflare dice que una página 502 o 504 con la marca de Cloudflare procede de tu servidor web de origen. Una página sin la marca de Cloudflare puede venir de Cloudflare, pero Cloudflare también indica que un problema de compresión en el origen es una causa de los 502 sin marca [7]. Así que la marca resuelve la mayoría de casos, pero no todos. Si la página no tiene marca y el origen responde directamente con 200, revisa la configuración de compresión del origen.

Citadel es el producto de protección HTTP/HTTPS de capa 7 de StealthRDP. No necesita un VPS de StealthRDP y se sitúa delante de tu origen como un proxy. Un 502 que ve el visitante puede significar, por tanto, que Citadel no puede llegar al origen. Revisa las comprobaciones del origen en la página Health de Citadel y la configuración del origen en la página Origin de Citadel.

¿Un 502 perjudica al SEO?

Un 502 breve apenas hace daño. La documentación de los rastreadores de Google indica que las respuestas 5xx y 429 hacen que sus rastreadores reduzcan la velocidad. Las URL que siguen devolviendo errores del servidor acaban eliminándose del índice, aunque al principio las URL ya indexadas se conservan. El rastreo vuelve a acelerarse cuando el servidor responde de nuevo con 2xx [8].

Lo práctico: corrige la causa cuanto antes. Un error que se mantiene mucho tiempo puede costar posiciones en los resultados.

Cómo prevenir los errores 502

• Monitoriza el sitio desde fuera. Una comprobación externa te avisa cuando empieza el 502, en lugar de que te lo comunique un visitante más tarde. Consulta herramientas de monitorización de uptime.
• Ten suficiente RAM. Los cierres por falta de memoria causan las líneas "prematurely closed connection". Si el servidor se queda sin memoria con regularidad, lee señales de que necesitas ampliar los recursos de tu VPS y problemas habituales de hosting VPS y sus soluciones.
• Reinicia la aplicación cuando falle. Una unidad systemd con una política de reinicio vuelve a levantar la aplicación tras una caída. Restart=on-failure reinicia el proceso solo cuando sale con un error. No arregla el fallo que provocó la caída, así que guarda las líneas del log del paso 2.

[Service]
ExecStart=/usr/bin/node /srv/myapp/server.js
Restart=on-failure
RestartSec=5

• Añade un health check. Dale a la aplicación un endpoint que devuelva 200 solo cuando pueda atender peticiones, y monitoriza ese endpoint. Un proceso que sigue en marcha pero bloqueado aparecerá entonces como fallo.
• Ten claro dónde mirar cuando el servidor se detiene. Si el servidor deja de responder por sí solo, lee por qué un servidor se detiene de forma aleatoria.

Cómo aplicar la solución tú mismo en un VPS de StealthRDP

Los planes Linux de StealthRDP incluyen acceso Root completo, así que tú instalas el servidor web y la aplicación, y puedes llevar a cabo todos los pasos de esta guía en tu propio servidor. Para comparar planes, consulta VPS Linux y planes de VPS.