¿Te salió el error 502? Te cuento todo lo que sé de este fallo desde dentro del servidor
El error 502 Bad Gateway, o como se traduce al español, "puerta de enlace incorrecta", es un código de estado HTTP dentro de la familia 5XX, es decir, un error del lado del servidor. Su definición oficial del IETF dice que se produce cuando el servidor, actuando como puerta de enlace o proxy, recibe una respuesta no válida de un servidor entrante al que accedió para satisfacer la solicitud. Dicho en cristiano: hay un problema de comunicación entre dos servidores, y el intermediario no sabe qué hacer con lo que le llega del servidor de origen.
En mis años dirigiendo proyectos de comercio electrónico y arquitectura IT, he visto este error más veces de las que puedo contar. Recuerdo una migración de un PrestaShop donde el nuevo hosting tardaba demasiado en arrancar los procesos PHP y cada petición generaba un 502 que desesperaba al equipo comercial. No era el navegador, ni el usuario, ni la conexión: era la cadena de servidores fallando en silencio.
Lo importante que quiero que tengas claro es que el 502 es ajeno a tu ordenador, tu navegador y tu conexión a Internet. El culpable suele ser el hosting o los servidores de la web. Cuando abres una página, tu navegador envía una petición HTTP; si todo va bien, recibes un código 200 (OK) y no ves nada. Si algo falla, el servidor devuelve un código de estado. Los 4XX son errores del cliente (tu solicitud está mal), los 5XX son del servidor, y el 502 pertenece a este segundo grupo.
Es fácil confundir el 502 con el 500 Internal Server Error, porque ambos funcionan como un "cajón de sastre" para fallos genéricos del servidor. La diferencia clave está en dónde ocurre el fallo: el 502 es específico de la comunicación entre un intermediario (proxy, gateway, CDN o balanceador) y el servidor de origen. Además, si el proxy no recibió ninguna respuesta HTTP del origen, lo correcto sería devolver un 504 Gateway Timeout, no un 502. Y si el servidor de origen envía una respuesta de error válida, esta debería retransmitirse tal cual al cliente en lugar de sustituirse por un 502.
Las causas del 502 se agrupan en cuatro bloques:
- Respuesta sin sentido: el otro servidor devolvió datos erróneos o incompletos.
- Formato incorrecto: la respuesta llega en un formato técnico que el intermediario no puede interpretar.
- Sobrecarga del servidor: el equipo está tan ocupado que no puede responder adecuadamente.
- Problemas de red: fallos en la conexión física o lógica entre servidores.
Si profundizamos en causas concretas, nos encontramos con el servidor web principal caído, un exceso de peticiones que satura el equipo, problemas de comunicación entre CDN y hosting, un proxy mal configurado, plugins o temas defectuosos que detienen scripts, y los tiempos de espera de PHP (max_execution_time, max_input_time) que se disparan durante migraciones. Personalmente, cuando gestionaba crisis en entornos de comunicaciones y e-commerce, el 502 por sobrecarga era pan diario en picos de tráfico, y la clave estaba en identificar si el cuello de botella estaba en el balanceador o en el backend.
“Si el mensaje dice '502 Bad Gateway Nginx', el fallo está entre el proxy inverso y el servidor de aplicación. Si es pantalla de Cloudflare, el problema es la cadena CDN → origen.”
Dato clave