Cargaste una página y te apareció 502 Bad Gateway. La versión corta: un servidor le pidió una respuesta a otro y recibió algo inválido. Es un error del lado del servidor: si solo estás visitando, no es tu culpa; si manejás el sitio, es señal de que tu backend está mal.
Qué significa 502 Bad Gateway
Los sitios modernos rara vez hablan directo con el backend. La petición pasa por una cadena — CDN, balanceador, proxy reverso (como Nginx) — antes de llegar al servidor de aplicación. Cuando uno de esos servidores intermedios (el "gateway") reenvía tu petición y recibe una respuesta inválida o vacía, devuelve un 502. Es un código 5xx: error del servidor.
Causas comunes
| Causa | Qué pasa |
|---|---|
| Upstream caído | La app backend crasheó o nunca arrancó |
| Backend sobrecargado | Demasiado tráfico; no responde a tiempo |
| Proxy mal configurado | Nginx/HAProxy apuntando a host/puerto equivocado |
| Proceso crasheado | PHP-FPM, Node o el worker murió a mitad de la petición |
| Firewall / DNS | El proxy no alcanza el origen |
Cómo arreglarlo — como visitante
- Recargá la página (muchos 502 son momentáneos).
- Esperá unos minutos y reintentá.
- Limpiá la caché o probá en ventana privada / otra red.
Cómo arreglarlo — como desarrollador
- ¿El origen está arriba? Confirmá que el proceso corre.
- Revisá la config del proxy (host/puerto upstream correctos).
- Leé los logs del backend — el 502 casi siempre tiene un crash o timeout asociado.
- Chequeá recursos (OOM, pool de conexiones agotado).
- Verificá red: firewall, security groups, DNS entre proxy y origen.
Cómo agarrar el próximo antes que tus usuarios
Lo peor de un 502 es enterarte por un cliente enojado. Nurbak Watch chequea tus endpoints desde varias regiones y trackea códigos de estado y tasas de error por ruta — un spike de 502 te avisa por Slack, email o WhatsApp apenas empieza.