Un error 502 Bad Gateway en WordPress — y su pariente cercano, el 504 Gateway Timeout — significa que un servidor le pidió su página a otro y no recibió a tiempo una respuesta útil. A diferencia de la mayoría de los errores de WordPress, este casi nunca tiene que ver con un archivo roto o un mal ajuste de un plugin. Tiene que ver con un servidor demasiado lento, demasiado ocupado o inalcanzable por un momento. Es frustrante, porque parece que no está en sus manos, pero hay cosas reales que puede revisar, y el patrón de cuándo ocurre dice mucho sobre la causa real.
Definiciones rápidas, porque los dos se confunden: un 502 Bad Gateway significa que el servidor devolvió una respuesta no válida. Un 504 Gateway Timeout significa que no devolvió nada antes de que se acabara el tiempo. Los dos apuntan al mismo problema de fondo — el servidor no pudo completar la solicitud — así que los arreglos se parecen.
Paso 1: descarte las casualidades
Antes de pensar lo peor, revise lo fácil:
- Vuelva a cargar al cabo de un minuto. Un 502 durante un fallo breve del servidor muchas veces se arregla solo. Si ya desapareció, fue un tropiezo momentáneo.
- Vacíe sus cachés. Un error guardado en caché puede quedarse. Vacíe la caché de su navegador y, si usa una CDN (red de entrega de contenido) o un plugin de caché, púrguela. Pruebe en una ventana privada para asegurarse de que ve el sitio en vivo.
- Compruebe si solo le pasa a usted. Pruebe desde su teléfono con datos móviles, o en un sitio que le diga si una página está caída para todos. Si solo lo ve usted, el problema puede estar en su red o en el DNS (los ajustes que dirigen su dominio a su servidor).
Paso 2: fíjese en cuándo ocurre
El momento es la mejor pista de la causa:
- Con picos de tráfico — el servidor no da abasto y empieza a rechazar solicitudes o a dejar que se agote su tiempo. Señal clásica de un plan con poca potencia.
- Durante una acción lenta concreta — un informe pesado, una importación grande, una búsqueda sobrecargada — la solicitud tarda más de lo que permite el límite de tiempo del servidor, y recibe un 504.
- Al azar, de vez en cuando — muchas veces un servidor compartido que no da más, o un proceso de PHP (el lenguaje de programación con el que funciona WordPress) que se cae y se reinicia una y otra vez.
Paso 3: lo que sí puede arreglar
Algunos 502/504 sí tienen una causa de su lado:
- Un plugin pesado o que se porta mal. Un plugin que hace llamadas lentas a servicios externos (un feed en vivo, una API que no responde) puede dejar colgada una solicitud hasta que se agota el tiempo. Desactive los plugins uno por uno — empezando por cualquiera que hable con un servicio externo — para ver si los errores paran.
- Un fallo de la CDN o del proxy. Si su sitio está detrás de una red de entrega de contenido y esta no puede llegar a su servidor de origen (su propio servidor detrás de esa red), devuelve un 502. Pausar por un momento el modo “proxy” puede decirle si el problema está en la CDN o en el origen.
- Procesos de PHP saturados. Su plan permite procesar a la vez un número limitado de solicitudes. Cuando todos los procesos están ocupados — muchas veces por consultas lentas o por un aumento del tráfico — las solicitudes nuevas esperan y luego se agota su tiempo. Menos solicitudes, y más rápidas (gracias a la caché), dejan más procesos libres.
Paso 4: use la caché a fondo para que el servidor trabaje menos
La defensa más eficaz contra los errores de tiempo de espera es hacer que el servidor genere cada página muchas menos veces. Una buena caché le sirve a la mayoría de los visitantes una copia ya preparada en lugar de armar la página desde cero cada vez, lo que libera esos procesos de PHP limitados y mantiene el sitio en pie durante un pico de tráfico. Nuestra guía sobre la caché de WordPress explica cómo encajan las distintas capas, y va de la mano con la pregunta más amplia de por qué un sitio WordPress es lento — un 504 muchas veces es solo lentitud a la que por fin se le acabó el tiempo.
Paso 5: si sigue pasando, es el servidor
Esta es la conclusión honesta: si ya vació las cachés, descartó un plugin colgado y los 502 o 504 siguen llegando — sobre todo cada vez que sube el tráfico — el problema es que el servidor no tiene la potencia ni el margen que su sitio necesita. No queda nada que arreglar en sus archivos. Es distinto de un error interno del servidor (500), que más a menudo tiene una causa dentro de su sitio; un 502/504 que se repite es la infraestructura diciéndole que se quedó sin espacio.
Cuando el arreglo es el proveedor, no el archivo
Casi todos los 502 o 504 que duran se reducen a una cosa: un servidor demasiado lleno o demasiado débil para el sitio que tiene. En el hosting compartido barato, su sitio comparte recursos con cientos de vecinos, así que un pico en cualquiera de ellos — o en el suyo — puede llevar a toda la máquina a los tiempos de espera agotados. No debería perder visitantes porque el tráfico de un desconocido saturó un servidor compartido.
Esa es una de las razones principales por las que la gente se pasa al hosting de WordPress administrado. En nuestra plataforma, los sitios no están amontonados peleando por las mismas sobras, la caché está bien configurada para que el servidor trabaje mucho menos por cada visitante, y todo está vigilado para que una falta de recursos se detecte antes de convertirse en una pared de errores 502. Cuando algo sale mal, del otro lado hay un equipo real con base en EE. UU., con soporte a cualquier hora, y un precio que sigue siendo predecible por mucho que crezca su tráfico. El plan está hecho para aguantar la carga, no para cobrarle por ella.
Un resumen rápido
- Vuelva a cargar, vacíe las cachés y confirme que no es solo su red.
- Fíjese en cuándo ocurre — con picos, con una acción lenta o al azar.
- Desactive los plugins pesados y revise cualquier capa de CDN o proxy.
- Use la caché a fondo para liberar los procesos de PHP limitados.
- Si sigue pasando con carga, la causa es el servidor.
Si los 502 y los 504 son parte de su día a día — sobre todo en sus momentos de más movimiento, que es justo cuando menos se los puede permitir — déjelo en nuestras manos. Mudarse a un hosting con recursos de verdad y una buena caché suele acabar con ellos para siempre, y es trabajo de rutina para nuestro equipo con base en EE. UU. Si su sitio también muestra otros errores, nuestra lista de revisión de emergencia cubre los síntomas parecidos.