Sábado, 21 de noviembre de 2026

Lo más relevante del hosting en el mundo, en español · ehost.ec →

Qué es el error 502 Bad Gateway y cómo solucionarlo en servidores y sitios web

El error 502 Bad Gateway indica que un servidor ha recibido una respuesta inválida de otro servidor intermedio; afecta a sitios web y APIs y puede ocurrir tanto en alojamiento compartido como en entornos cloud. Te explicamos causas comunes, impacto y pasos prácticos para administradores y propietarios de sitios.

Por Equipo ehost3 min de lecturaFuente: One.com
Qué es el error 502 Bad Gateway y cómo solucionarlo en servidores y sitios web
Imagen ilustrativa generada con inteligencia artificial.

El mensaje «502 Bad Gateway» aparece cuando un servidor que actúa como puerta de enlace o proxy (por ejemplo, un balanceador, un proxy inverso o un CDN) recibe una respuesta inválida o inesperada del servidor de origen. Es un error de comunicación entre componentes que impide servir la página al visitante y suele manifestarse con páginas en blanco, mensajes genéricos del navegador o respuestas JSON vacías en APIs.

Qué significa el error 502 Bad Gateway

En términos sencillos, el 502 no es un fallo del navegador del usuario ni necesariamente del sitio web en sí, sino una ruptura en la cadena de comunicación entre dos servidores. Componentes habituales implicados: balanceadores de carga (HAProxy, Amazon ELB), proxies inversos (Nginx, Varnish), CDNs, o servidores de aplicaciones (PHP-FPM, Node.js, Gunicorn) y servidores web (Nginx, Apache).

Principales causas

  • Servidor de origen caído o no responde: el backend está detenido, saturado o reiniciándose.
  • Timeouts entre servidores: la respuesta tarda más del permitido y la puerta de enlace corta la conexión.
  • Configuración incorrecta del proxy o del servidor web: rutas, puertos o directivas mal configuradas que impiden la conexión al backend.
  • Errores en el servidor de aplicaciones: fallos en procesos de PHP-FPM, procesos Node.js colgados o errores fatales que devuelven respuestas inválidas.
  • Problemas de DNS o resolución: la puerta de enlace no puede resolver la dirección del backend correctamente.
  • Actualizaciones o despliegues: durante un deploy, algunos procesos pueden reiniciarse y dar respuestas temporales inválidas.

Qué deben hacer los administradores y dueños de sitios

A continuación, pasos prácticos para diagnosticar y resolver un 502. No todos aplican a todos los entornos; siga el flujo que corresponda a su arquitectura.

  1. Comprobar el estado del servicio de origen: verifique que el servidor de aplicaciones (PHP-FPM, Node, Gunicorn, etc.) y la base de datos estén activos y sin errores en sus logs.
  2. Revisar logs del proxy y del servidor web: consulte los registros de Nginx/Apache/HAProxy para identificar códigos de error, timeouts o respuestas vacías que coincidan con la hora del incidente.
  3. Aumentar temporalmente timeouts: si observa que las peticiones tardan, ajuste los timeouts del proxy/balanceador para permitir respuestas más largas mientras se investiga la causa de la lentitud.
  4. Probar conexión directa al backend: desde el servidor proxy, haga una petición directa al puerto del backend (por ejemplo, curl al puerto del servicio) para comprobar si responde correctamente.
  5. Comprobar límites de procesos y memoria: asegúrese de que no está agotando procesos PHP-FPM, workers de Node o la memoria del servidor; ajuste cantidades o reinicie procesos con cuidado.
  6. Verificar DNS y resolución interna: confirme que el proxy resuelve la IP correcta del backend y que no hay registros DNS erróneos o caches desactualizados.
  7. Evaluar recent changes: si hubo un despliegue o cambio de configuración reciente, revertir o revisar esos cambios puede identificar la causa.
  8. Monitorización y límites de rate: compruebe si sistemas de protección (WAF, rate limiting) están bloqueando o limitando conexiones legítimas hacia el backend.

Buenas prácticas para prevenir 502 Bad Gateway

  • Configuración de health checks: habilite comprobaciones de estado en el balanceador para detectar e inhabilitar backends que no responden.
  • Escalado automático y límites conservadores: dimensione workers y timeouts según la carga esperada y utilice escalado para cargas puntuales.
  • Logs centralizados y alertas: envíe logs a un sistema central y configure alertas por aumentos de 502 o timeouts.
  • Despliegues atómicos: implemente estrategias que eviten interrumpir todos los backends al mismo tiempo (rolling deploys, blue/green).
  • Pruebas de carga y resiliencia: someta la arquitectura a pruebas de carga para identificar puntos de fallo y ajustar recursos.

Nota: este resumen explica causas y medidas prácticas. Si su proveedor publica instrucciones específicas o hay una incidencia global en su plataforma, consulte sus comunicados para acciones concretas.

Lee también:

Fuente: One.com

Compartir