Error 502: ¿cómo resolverlo?

El error 502 Bad Gateway indica que un servidor que actúa como intermediario ha recibido una respuesta no válida del servidor de origen. Suele ser temporal y, en la mayoría de los casos, se resuelve recargando la página, limpiando la caché, revisando el CDN y las DNS o comprobando el estado del servidor de tu alojamiento.

Qué es el error 502

El error 502 es un código de estado HTTP que el servidor devuelve cuando algo ha fallado en la cadena de comunicación entre servidores. Forma parte de la familia de errores que empiezan por 5, los que indican un problema en el lado del servidor y no en el del usuario. Cuando aparece, el navegador muestra un mensaje del tipo «502 Bad Gateway» y la página no llega a cargarse. Lo importante es entender que, casi siempre, el problema no está en tu ordenador ni en tu conexión, sino en el servidor que sirve la web o en alguno de los intermediarios que hay entre tú y ese servidor.

Qué significa 502 Bad Gateway

«Bad Gateway» se traduce como «puerta de enlace incorrecta». Muchas webs no se sirven directamente desde un único servidor, sino que utilizan intermediarios: un proxy inverso, un balanceador de carga o una red de distribución de contenidos (CDN). Ese intermediario actúa como puerta de enlace y, cuando reenvía tu petición al servidor de origen, espera una respuesta válida. Si la respuesta que recibe es inválida, está vacía o llega corrupta, no puede entregártela y responde con un 502. En entornos habituales esto ocurre, por ejemplo, cuando un servidor web como Nginx hace de proxy hacia el procesador de PHP y este último no responde correctamente.

Causas del error 502

Las causas del error 502 son variadas, pero casi todas tienen que ver con el servidor de origen o con los intermediarios. Las más frecuentes son: que el servidor de origen esté caído, saturado o reiniciándose; que el procesador de PHP o la aplicación hayan superado el tiempo de espera; que un cortafuegos esté bloqueando la comunicación entre el intermediario y el origen; que haya un problema temporal en el CDN; o que exista un error de configuración en el servidor tras un cambio reciente. También un pico inesperado de tráfico puede provocar un 502 pasajero.

Cómo resolver el error 502

Antes de alarmarte, conviene descartar las soluciones más sencillas, ya que en muchos casos el error es temporal y se corrige en pocos minutos. Estos son los pasos recomendados, de lo más simple a lo más técnico.

Recarga la página

Como el 502 suele ser temporal, lo primero es volver a cargar la página pasados unos segundos. Pulsa F5 o el botón de recarga; en muchas ocasiones, si el servidor solo estaba saturado o reiniciándose, la web vuelve a funcionar sin más.

Limpia la caché del navegador

A veces el navegador conserva una versión almacenada de la página con el error. Limpiar la caché del navegador, o abrir la web en una ventana de incógnito, obliga a solicitar de nuevo el contenido al servidor y descarta que el problema esté en tu copia local.

Desactiva temporalmente el CDN

Si utilizas un servicio de CDN como Cloudflare, puede ser el origen del 502. Desactivarlo de forma temporal o ponerlo en modo de solo DNS permite comprobar si el error desaparece. Si al hacerlo la web carga, el problema está en la capa del CDN y no en tu servidor.

Comprueba la configuración de las DNS

Una configuración de DNS incorrecta, por ejemplo tras migrar el dominio o cambiar de servidor, puede dirigir las peticiones a un destino equivocado y provocar el 502. Verifica que los registros DNS apuntan a la dirección IP correcta y ten en cuenta que los cambios de DNS pueden tardar un tiempo en propagarse por completo.

Revisa el servidor y contacta con tu proveedor de hosting

Si lo anterior no resuelve el problema, el origen suele estar en el servidor: servicios caídos, límites de recursos superados o un error en la configuración. Revisa los registros de error (logs) si tienes acceso a ellos y, si el servidor no responde, contacta con el soporte de tu proveedor de alojamiento para que comprueben el estado de los servicios.

Cómo prevenir el error 502

Aunque ningún servidor está totalmente libre de incidencias, un buen alojamiento reduce mucho la probabilidad de encontrarte con un 502. Contar con recursos suficientes, una infraestructura estable y un soporte que reaccione con rapidez marca la diferencia. Alojar tu web en un servicio de hosting con tecnología LiteSpeed, discos NVMe y soporte 24/7 ayuda a mantener los servicios disponibles y a resolver con agilidad cualquier saturación puntual antes de que afecte a tus visitantes.

Otros errores de servidor relacionados con el 502

El 502 no es el único error de la familia 5xx que puedes encontrarte, y distinguirlos ayuda a localizar el problema más rápido. El error 500 (Internal Server Error) es un fallo genérico del servidor, a menudo provocado por un error en el código, en un plugin o en el archivo de configuración. El 503 (Service Unavailable) aparece cuando el servidor no está disponible de forma temporal, normalmente por mantenimiento o por una sobrecarga de recursos. El 504 (Gateway Timeout) es muy parecido al 502, pero en este caso el intermediario no recibe ninguna respuesta del servidor de origen dentro del tiempo de espera, en lugar de recibir una respuesta inválida. Saber diferenciar estos códigos te permite comunicar mejor la incidencia al soporte de tu proveedor y acelerar la resolución, ya que cada uno orienta hacia una causa distinta.

Preguntas frecuentes

¿El error 502 es culpa de mi ordenador?

Casi nunca. El 502 es un error del lado del servidor, lo que significa que el problema está en la web que intentas visitar o en alguno de sus intermediarios, no en tu equipo ni en tu conexión. Aun así, recargar la página o limpiar la caché del navegador ayuda a descartar una copia local defectuosa.

¿Cuánto dura normalmente un error 502?

Depende de la causa. Si se debe a una saturación puntual o a un reinicio, suele desaparecer en segundos o pocos minutos. Si persiste durante más tiempo, indica un problema de configuración o de recursos en el servidor que requiere la intervención del administrador o del proveedor de hosting.

¿Qué diferencia hay entre el error 502 y el 503?

El 502 (Bad Gateway) indica que un intermediario recibió una respuesta inválida del servidor de origen. El 503 (Service Unavailable) señala que el servidor está temporalmente no disponible, normalmente por sobrecarga o mantenimiento. Ambos son errores del servidor, pero apuntan a situaciones distintas.