El error HTTP 502 significa que un servidor intermedio recibió una respuesta incorrecta del servidor real
El error HTTP 502, «Bad Gateway» (puerta de enlace incorrecta), significa que el servidor al que llegaste era solo un intermediario, y el servidor que está detrás respondió algo no válido o no respondió nada útil. El intermediario (Nginx, Apache, Cloudflare, un balanceador de carga de AWS) funciona bien; lo que falla es lo que hay detrás.
El código pertenece a la familia 5xx, así que, por definición, es un error del lado del servidor. Es más preciso que un 500: indica que el fallo ocurrió en el traspaso entre la puerta de enlace y el servidor de aplicaciones. La página de referencia de MDN (actualizada el 22 de junio de 2026) añade que, si el servidor de origen hubiera enviado un error HTTP válido, la puerta de enlace debería haberlo transmitido; un 502 significa que la puerta de enlace no tenía nada válido que transmitir.
Lo ves como una página blanca sencilla que dice '502 Bad Gateway' en el navegador, como 'HTTP error! status: 502' dentro del cuadro de error de una app, y en Zoom, juegos o apps de trading como un 'error del servidor' genérico con el 502 escondido en los detalles. Siempre significa lo mismo: el back end del servicio no respondió a su propia puerta de entrada.
El servidor, mientras actuaba como puerta de enlace o proxy, recibió una respuesta no válida de un servidor entrante al que accedió al intentar atender la solicitud.
RFC 9110, citado en la página de Authgear sobre el 502
La solicitud pasa por una puerta de enlace, y ahí es donde nace un 502
Un 502 lo genera el salto intermedio: tu navegador habla con una puerta de enlace (un proxy inverso, una CDN o un balanceador de carga), la puerta de enlace habla con el servidor de aplicaciones y devuelve un 502 cuando falla ese último salto.
La página de Authgear enumera las cuatro formas en que falla el último salto: el servidor de aplicaciones no está en marcha, cierra la conexión de forma inesperada, devuelve una respuesta HTTP mal formada o tarda más que el tiempo de espera de la puerta de enlace. En los cuatro casos la puerta de enlace no tiene nada válido que transmitir, así que escribe su propia página de error breve y envía esa en su lugar.
La marca que aparece en la página de error indica qué intermediario dejó de intentarlo. Un 502 con el estilo de Cloudflare significa que Cloudflare no pudo obtener una respuesta correcta del servidor de origen del sitio. Una página sencilla que dice 'nginx' u 'openresty' al final significa que el proxy del propio sitio no pudo comunicarse con su propia app en la misma máquina o red.
Señales de que el fallo es del sitio
- Otras personas reportan el mismo error al mismo tiempo
- La página de error muestra la marca del sitio o de la CDN
- Fallan todas las páginas del sitio, no solo una
- Tu teléfono con datos móviles muestra el mismo error 502
Señales de que el problema está de tu lado
- El sitio funciona ahora mismo para un amigo
- Solo aparece en una red (casa, cafetería, oficina)
- Desaparece al cambiar de servidor VPN o al desactivar la VPN
- Empezó justo después de cambiar la configuración de DNS o del proxy
502, 503 y 504 son tres situaciones distintas que vienen de la misma puerta de enlace
Un 502 significa que el servidor de origen respondió mal, un 503 significa que el servicio no está disponible a propósito o está sobrecargado, y un 504 significa que el servidor de origen no respondió en absoluto antes de que se agotara el tiempo de espera de la pasarela.
La diferencia importa porque cambia lo que debes hacer. Un 503 suele venir con una indicación Retry-After y se resuelve en el plazo indicado. Un 504 apunta a lentitud, así que la solución es esperar o ajustar el tiempo de espera. Un 502 apunta a una caída, un puerto incorrecto o una respuesta dañada, y requiere que alguien intervenga en el servidor.
| Código | Lo que vio la puerta de enlace | Quién suele solucionarlo | Qué puede hacer un visitante |
|---|---|---|---|
| 500 Internal Server Error | La propia aplicación generó un error | Los desarrolladores del sitio | Recarga una vez y espera |
| 502 Bad Gateway | Una respuesta no válida o vacía del servidor de origen | Administradores del sitio (proxy o aplicación) | Recarga la página, prueba en otra red y espera |
| 503 Service Unavailable | El servicio indicó que está caído o sobrecargado | Administradores del sitio, a menudo a propósito durante el mantenimiento | Espera el tiempo indicado en Retry-After |
| 504 Gateway Timeout | No hubo ninguna respuesta dentro del tiempo de espera de la puerta de enlace | Administradores del sitio (back end lento o ajuste de tiempo de espera) | Espera unos minutos y vuelve a intentarlo |
Qué hacer si ves el error HTTP 502 como visitante
Recarga una vez después de una breve pausa y prueba la misma página desde una segunda red. Si las dos fallan, el sitio está caído y nada de lo que hagas en tu dispositivo lo cambiará.
Creemos que la mayoría de los visitantes le da demasiadas vueltas a un error 502. El consejo sincero es esperar tres minutos antes de tocar cualquier ajuste, porque, si un proceso del sitio se ha detenido, su propio sistema de supervisión suele reiniciarlo en ese tiempo. Los pasos de abajo son para la minoría de casos en que el error depende de tu dispositivo o de tu red.
Recarga después de esperar un poco
Cuenta hasta treinta y vuelve a cargar la página. Un error 502 causado por un servidor interno que se está reiniciando suele desaparecer al segundo o tercer intento.
Prueba con otra red
Abre la misma dirección en tu teléfono con datos móviles. Si el error 502 también aparece ahí, deja de buscar fallos: el problema es del sitio.
Vacía la caché de DNS
En Windows, abre Terminal como administrador y ejecuta ipconfig /flushdns y después netsh winsock reset, tal como sugiere una respuesta de la comunidad de Microsoft del 20 de abril de 2026. Una entrada de DNS obsoleta puede llevarte a una puerta de enlace que ya no funciona bien.
Cambia de servidor VPN o desactiva la VPN para probar
Si usas una VPN, elige un servidor de otro país y recarga la página. Si algo cambia, significa que una ubicación de acceso fallaba, no tu dispositivo. Después, vuelve a activar la VPN si la necesitas.
Consulta la página de estado del sitio o su cuenta en redes sociales
Los servicios grandes publican sus caídas en pocos minutos. Si indican «investigando», cierra la pestaña y vuelve más tarde.
Borra las cookies solo de ese sitio
No es habitual, pero una cookie de sesión dañada puede hacer que una puerta de enlace de autenticación rechace la solicitud y devuelva un 502. Borra las cookies de ese dominio, no las de todo el navegador.
Si administras el sitio, tres soluciones resuelven la mayoría de los 502
Reinicia el servidor upstream que se ha caído, haz que el proxy apunte al puerto correcto y aumenta el tiempo de espera de lectura del proxy. Según Authgear, en nueve de cada diez casos la causa es una de estas tres.
Además de esas tres, las causas más habituales son un balanceador de carga cuyas comprobaciones de estado han marcado todos los backends como no disponibles, un proxy que guardó en caché una respuesta DNS antigua del upstream, un fallo en el handshake TLS entre el proxy y el upstream, o un upstream que se queda sin memoria o sin procesos de trabajo. Cada una deja una línea en el registro de errores del proxy, así que lee ese registro antes de cambiar la configuración.
Comprueba que la aplicación está escuchando
Ejecuta ss -tlnp | grep <port> en el servidor. Si no hay nada escuchando en el puerto que espera el proxy, inicia la aplicación y averigua por qué se detuvo.
Revisa el destino del proxy
En Nginx, mira proxy_pass; en Apache, mira ProxyPass. Un puerto incorrecto, una ruta de socket equivocada o http:// cuando la aplicación usa https:// provocan un 502 de forma casi segura.
Compara los tiempos de espera con los tiempos de respuesta reales
Si la aplicación simplemente es lenta, aumenta proxy_read_timeout (Nginx) o ProxyTimeout (Apache) y después analiza el rendimiento del endpoint lento para que el tiempo de espera no esté ocultando un error.
Reproduce el error con curl desde el host del proxy
curl -v http://127.0.0.1:<puerto>/ desde la misma máquina muestra si el servidor upstream responde y si sus cabeceras son HTTP válido.
Revisa el estado del balanceador de carga
En AWS ALB, Kubernetes Ingress o similares, un grupo de destino sin ningún backend en buen estado devuelve 502 a todo el mundo. Corrige la ruta de la comprobación de estado o la respuesta de disponibilidad de la app.
Una VPN rara vez causa un 502, pero un servidor de salida puede llevarte a un nodo de borde que falle
Una VPN no genera errores 502 por sí sola; MDN cita las VPN y otras configuraciones de red personalizadas como una excepción que solo vale la pena revisar cuando el sitio funciona para todos los demás.
Este es el motivo por el que cambiar de servidor a veces ayuda. Los sitios grandes responden desde el nodo de borde de la CDN más cercano a tu dirección IP de salida. Si ese nodo, o su ruta de vuelta al servidor de origen, tiene problemas, todos los que salen por esa misma salida ven un 502, mientras que en otros lugares se navega con normalidad. Elegir un servidor en otro país te lleva a un nodo distinto, lo cual es una prueba legítima, no un truco. Puedes comprobar en qué salida estás en tealvpn.com/what-is-my-ip antes y después del cambio.
Teal VPN, creada por Fxolio LLC, tiene un plan gratuito (500 MB al día) y un plan Pro, con apps para Android, Windows, Mac, Linux, Android TV y Chromebook, y servidores en 14 países a noviembre de 2026. Teal Secure está activo en todas las conexiones y en todos los planes: disimula el tráfico de la VPN y la app prueba otras rutas por sí sola cuando una red cierra una. Esto ayuda en redes que restringen las VPN; no sirve de nada ante un 502, porque un 502 es un fallo del propio back end del sitio. Ninguna VPN puede garantizar la conexión en todas las redes, y ninguna VPN puede arreglar el servidor de otra persona.
- Antes de culpar a la VPN: ¿aparece el 502 con la VPN desactivada, en la misma red?
- ¿Aparece también con un servidor de otro país?
- ¿La página de error muestra el nombre de una CDN (Cloudflare, Fastly) en lugar del nombre del sitio?
- ¿Un amigo fuera de tu red recibió el mismo error en el mismo minuto?
Los propietarios de sitios web evitan que se repitan los errores 502 con comprobaciones de estado y tiempos de espera realistas
Los errores 502 repetidos se detienen cuando el proxy conoce el estado real de la aplicación: un endpoint de disponibilidad al que llama la comprobación de estado, un gestor de procesos que reinicia la aplicación si falla, y un tiempo de espera del proxy basado en tiempos de respuesta medidos y no en una suposición.
Otros dos hábitos dan buen resultado. Mantén corta la caché DNS del proxy para el servidor upstream, de modo que un nuevo despliegue en otra dirección no deje al proxy apuntando a la anterior. Y configura alertas sobre la cantidad de errores 502 en sí, no solo sobre la CPU o la memoria, porque una línea proxy_pass incorrecta genera carga cero y un cien por cien de errores.
Sigue leyendo
Referencias
- 502 Bad Gateway - HTTP | MDN
- HTTP 502 Bad Gateway: Causes & Fixes | Authgear
- how do you get 502 - Microsoft Q&A
¿Necesitas ayuda con Teal VPN? Contacta con soporte.
Preguntas
¿Qué significa el error HTTP 502?
Significa que un servidor que actúa como puerta de enlace o proxy recibió una respuesta no válida, o ninguna respuesta útil, del servidor que tiene detrás. La puerta de enlace funciona bien; el servidor de la aplicación no respondió como debía.
¿El error HTTP 502 es culpa mía?
Casi nunca. Es un código 5xx, que por definición es del lado del servidor. Prueba en una segunda red; si el 502 aparece también ahí, el problema es del sitio y lo único que hay que hacer es esperar.
¿Cuánto dura un error 502?
Con frecuencia, de unos segundos a unos minutos, porque el monitoreo reinicia un proceso que se ha caído. Si dura más de quince minutos, los administradores del sitio tienen un problema de configuración y no una simple caída, y solo ellos pueden solucionarlo.
¿Cuál es la diferencia entre 502 y 504?
Un 502 significa que el servidor de origen respondió con algo no válido; un 504 significa que no respondió en absoluto antes de que se agotara el tiempo de espera de la puerta de enlace. MDN marca justo esa línea: si el origen no da ninguna respuesta HTTP, se produce un 504; si da una respuesta incorrecta, un 502.
¿Puede una VPN solucionar un error HTTP 502?
Solo en el caso poco frecuente de que un nodo de borde de la CDN cercano a tu IP de salida tenga problemas. Si cambias a un servidor de Teal VPN en otro país, te conectas a un nodo distinto; si el error continúa, el servidor de origen del sitio está caído y ninguna VPN puede ayudar.
¿Por qué Zoom o un juego muestran el error HTTP 502?
Las apps se comunican con el mismo tipo de gateways que los sitios web. Cuando el back end del servicio falla o está sobrecargado, el gateway de la app devuelve un 502 y la app lo muestra como «HTTP error! status: 502» o como un error genérico del servidor.
¿Qué significa un 502 de ngrok?
El túnel llegó a tu equipo, pero nada respondió en el puerto local al que le indicaste a ngrok que reenviara el tráfico. Inicia la app local en ese puerto o corrige el puerto en el comando de ngrok.