Usted visita su sitio y ve una pantalla en blanco con tres palabras: «502 Bad Gateway». El tráfico fluye, pero los visitantes ven un error en lugar del contenido. Las ventas se estancan, el posicionamiento SEO cae y usted pierde tiempo haciendo conjeturas.

El error 502 parece alarmante, pero en realidad es simplemente un fallo de comunicación entre servidores. Su sitio no está roto, los datos no han desaparecido y, en la mayoría de los casos, la solución toma entre cinco y quince minutos. A continuación encontrará una guía paso a paso que lo lleva desde las comprobaciones más simples hasta diagnósticos más profundos.

💡 Resumen rápido:

• Actualice la página y verifique si el servidor de alojamiento está caído
• Limpie la caché de su navegador y desactive temporalmente el CDN
• Si el error persiste, desactive los plugins por FTP y revise el tema
• Restablezca el .htaccess y contacte a su proveedor de alojamiento cuando todo lo demás falle

Qué es un error 502 Bad Gateway

Cuando usted abre un sitio, el navegador envía una solicitud HTTP. Del lado del servidor, un proxy inverso (Nginx, Apache) la recibe y distribuye las solicitudes entre el servidor de aplicaciones (PHP), la base de datos, el servidor web estático y el CDN. Cada nodo procesa su parte y devuelve el resultado al servidor proxy. El proxy ensambla la respuesta y la entrega al navegador, y la página carga.

Un error 502 ocurre cuando uno de los servidores en esa cadena devuelve una respuesta no válida al servidor proxy. El proxy no puede ensamblar la página y muestra «Bad Gateway». El navegador informa honestamente que la puerta de enlace entre servidores recibió algo inesperado.

Externamente, el error puede adoptar varias formas: «502 Bad Gateway», «502 Service Temporarily Overloaded», «HTTP 502», «Nginx 502 Bad Gateway», «Proxy Error». La esencia es la misma: en algún punto de la cadena hay una interrupción.

Por qué ocurre el error 502

Las causas casi siempre están del lado del servidor, pero a veces sus propias acciones en el sitio lo desencadenan:

• Sobrecarga del servidor. Un pico repentino de tráfico agota los recursos del alojamiento y los procesos PHP no pueden atender la cola de solicitudes.
• Plugin o tema defectuoso. Un código que causa un error fatal de PHP interrumpe la respuesta del servidor de aplicaciones y el proxy no recibe nada.
• Problemas con el CDN. Cloudflare, KeyCDN u otro servicio de distribución de contenido no puede conectarse al servidor de origen y devuelve un 502.
• Registros DNS incorrectos. Después de cambiar de proveedor de alojamiento o actualizar los servidores DNS, los registros aún no se han propagado, por lo que el sitio está temporalmente inaccesible.
• .htaccess dañado. Una sintaxis rota o reglas de reescritura conflictivas interrumpen el manejo de solicitudes.
• Límite de memoria PHP agotado. Un plugin o script pesado consume toda la memoria disponible y el proceso falla.

Ahora repasemos cada solución paso a paso, desde la más rápida hasta la más compleja.

Paso 1. Actualice la página

Lo primero y más simple: presione F5 o Ctrl+R. Si el error fue causado por una falla breve del servidor, la solicitud repetida tendrá éxito. Intente abrir el sitio en otro navegador o con datos móviles; esto descarta un problema de su lado.

Verifique si el sitio funciona para el resto del mundo usando isup.me o Down For Everyone Or Just Me. Si el servicio muestra que el sitio está caído solo para usted, el problema es local, así que continúe. Si el sitio no está disponible para todos, lo más probable es que el servidor de alojamiento haya fallado o se haya aplicado un bloqueo a nivel del proveedor.

Paso 2. Limpie la caché del navegador

El navegador almacena en caché no solo imágenes y estilos, sino también respuestas erróneas del servidor. Una actualización forzada (Ctrl+F5 en Windows, Cmd+Shift+R en macOS) obliga al navegador a solicitar la página de nuevo, omitiendo la caché local.

Si una actualización forzada no ayudó, limpie la caché por completo. En Chrome: Configuración → Privacidad y seguridad → Borrar datos de navegación → «Archivos e imágenes almacenados en caché». Cubrimos instrucciones detalladas para varios navegadores y la limpieza de caché del lado de WordPress en una guía separada.

Paso 3. Desactive temporalmente el CDN

Las redes de distribución de contenido como Cloudflare o KeyCDN enrutan el tráfico a través de sus propios servidores. Si ocurre una falla del lado del CDN o se configura una regla de firewall incorrecta, los visitantes verán un 502 incluso cuando el servidor de origen esté completamente operativo.

Para probar esta hipótesis, pause el CDN en su panel de control. Cloudflare: vaya a Overview → Pause Cloudflare. KeyCDN y servicios similares: busque el botón Disable o Pause en el panel. Después de desactivarlo, actualice su sitio. Si el error desaparece, el problema está del lado del CDN; contacte a su soporte.

Mientras el CDN está desactivado, el sitio funciona directamente desde su alojamiento, por lo que la velocidad puede bajar ligeramente, pero la disponibilidad se restablecerá. Comparamos servicios de CDN populares y su configuración en un artículo sobre CDN gratuitos para WordPress.

Paso 4. Revise la configuración DNS

Después de cambiar de proveedor de alojamiento o actualizar los registros NS, la información DNS se propaga por la red durante un período que va de varias horas a 48 horas. Durante este tiempo, algunos visitantes pueden llegar al servidor antiguo, que no responde o responde incorrectamente.

Si migró su sitio recientemente, espere 24 horas; eso suele ser suficiente. Adicionalmente, vacíe su caché DNS local: en Windows abra el Símbolo del sistema y ejecute ipconfig /flushdns; en macOS ejecute sudo dscacheutil -flushcache y sudo killall -HUP mDNSResponder. Luego actualice la página.

Paso 5. Desactive los plugins por FTP

La causa más común de un 502 en WordPress es un conflicto de plugins. Un solo plugin problemático puede causar un error fatal de PHP que derribe todo el sitio. Dado que el panel de administración de WordPress es inaccesible durante un 502, necesitará desactivar los plugins a través del sistema de archivos.

Conéctese al servidor por FTP (usando FileZilla, WinSCP) o abra el Administrador de archivos en cPanel. Navegue a la carpeta raíz del sitio (generalmente public_html):

Entre en wp-content y busque la carpeta plugins. Cámbiele el nombre, por ejemplo a plugins.old. Esto desactiva instantáneamente todos los plugins a la vez. Los datos de los plugins no se eliminan al cambiar el nombre de la carpeta; la configuración permanece en la base de datos:

Actualice el sitio. Si funciona, el problema es uno de los plugins. Cambie el nombre de la carpeta de nuevo a plugins, vaya al panel de administración y active los plugins uno por uno, revisando el sitio después de cada activación. Una vez que encuentre al culpable, elimínelo por FTP o sustitúyalo por una alternativa.

Paso 6. Revise el tema activo

Si desactivar los plugins no ayudó, el siguiente sospechoso es el tema. Un código incorrecto en functions.php o un conflicto con la versión de PHP pueden causar igualmente un error fatal y un 502.

Regrese a la carpeta raíz del sitio → wp-content → themes. Encuentre la carpeta del tema activo y cámbiele el nombre (por ejemplo, añada .old al final):

WordPress cambiará automáticamente al tema predeterminado (Twenty Twenty-Four, Twenty Twenty-Five o similar). Actualice el sitio; si el error desaparece, el problema es el tema. Contacte al desarrollador del tema o restaure una copia de seguridad. Después del diagnóstico, cambie el nombre de la carpeta de vuelta a su nombre original.

Un algoritmo detallado para revisar temas y localizar código conflictivo se describe en la guía para solucionar problemas de temas de WordPress.

Paso 7. Restablezca el archivo.htaccess

Un .htaccess dañado es una causa frecuente pero menos obvia de un 502. Las reglas de reescritura añadidas por un plugin de caché o un plugin de seguridad pueden entrar en conflicto entre sí. Un solo error de sintaxis en este archivo y el servidor devuelve un 502 en todas las solicitudes.

Conéctese por FTP y localice el archivo .htaccess en la carpeta raíz del sitio. Descargue una copia de seguridad a su computadora, luego elimine el archivo del servidor. Vaya al panel de administración de WordPress, navegue a Ajustes → Enlaces permanentes y haga clic en «Guardar cambios» (sin cambiar nada). WordPress creará un nuevo .htaccess con un conjunto limpio de reglas.

Si el error apareció inmediatamente después de instalar un plugin de caché (WP Rocket, W3 Total Cache, LiteSpeed Cache), revise la sección con las reglas de ese plugin en .htaccess; generalmente está envuelta en comentarios como # BEGIN W3TC / # END W3TC. Elimine ese bloque, guarde el archivo y actualice el sitio.

Paso 8. Contacte a su proveedor de alojamiento

Si ninguno de los pasos anteriores ayudó, lo más probable es que el problema esté del lado del servidor. Contacte al soporte técnico de su proveedor de alojamiento y proporcione el dominio, la hora en que apareció el error y qué pasos ya ha realizado. Cuanto más detalle dé, más rápido encontrarán los ingenieros la causa.

Pídales que revisen los registros de errores de PHP y del servidor web durante el período en que apareció el 502. Los registros casi siempre muestran exactamente qué script o módulo está causando la falla. En planes de alojamiento compartido económicos, la causa puede ser simplemente la falta de recursos: un sitio en el servidor consume toda la memoria y el resto recibe un 502. En ese caso, tiene sentido considerar mudarse a un VPS o alojamiento en la nube con recursos garantizados.

Videoguía

Vea un recorrido visual para diagnosticar y solucionar el error 502, desde el primer paso hasta el último, en este video:

⁉️🤔 Preguntas frecuentes

¿Puede un error 502 resolverse por sí solo?

Sí, si la causa es una sobrecarga breve del servidor de alojamiento. Los proveedores monitorean la carga y reinician automáticamente los procesos problemáticos en un plazo de uno a cinco minutos. Actualice la página después de un par de minutos; en la mitad de los casos, el error desaparece sin ninguna acción de su parte.

¿Cómo distingo un 502 de otros errores de servidor?

Un 502 Bad Gateway es un error a nivel del servidor proxy (Nginx/Apache), no de la aplicación en sí. Un 500 Internal Server Error indica un problema directamente en el código PHP o la configuración. Un 503 Service Unavailable significa que el servidor no está aceptando solicitudes temporalmente, generalmente durante un mantenimiento programado. Un 504 Gateway Timeout significa que el servidor no recibió una respuesta del servidor ascendente dentro del tiempo asignado. Para el usuario, la diferencia se reduce al diagnóstico: un 500 se soluciona con mayor frecuencia editando código, mientras que un 502 se soluciona restableciendo la comunicación entre servidores.

¿Necesito restaurar el sitio desde una copia de seguridad por un 502?

Una copia de seguridad es un último recurso, no un primer paso. Antes de desplegar una copia de seguridad, siga los pasos 5, 6 y 7 de esta guía: desactive los plugins, revise el tema, restablezca .htaccess. En la gran mayoría de los casos, un 502 se resuelve sin restaurar una copia de seguridad. Despliegue una copia de seguridad solo si el error apareció inmediatamente después de actualizar WordPress, los plugins o un tema y no es posible revertir los cambios por FTP.

¿Puedo prevenir errores 502 en el futuro?

Parcialmente sí. Use un alojamiento de calidad con suficiente memoria PHP (el mínimo recomendado es 256 MB). Configure el monitoreo de disponibilidad para su sitio a través de UptimeRobot o un servicio similar; se enterará de un problema antes de que los visitantes lo reporten. Antes de instalar o actualizar plugins, haga una copia de seguridad rápida. Y tenga a mano el acceso FTP: cuando el panel de administración está caído, es la única forma de desactivar rápidamente el código problemático.

¿Qué hacer si nada funcionó?

Los ocho pasos anteriores cubren casi todos los escenarios de un 502 Bad Gateway en WordPress. Si ha revisado los plugins, el tema, el DNS y el CDN, restableció .htaccess y el error persiste, el problema es más profundo y no puede prescindir de los ingenieros de alojamiento.

La secuencia correcta ahorra horas: primero descarte las causas locales (caché, navegador, CDN), luego las causas del lado del servidor (plugins, tema, .htaccess) y solo entonces escale al proveedor. Guarde esta guía en sus marcadores; un 502 tiene la costumbre de regresar en el peor momento posible, y un acceso rápido a la lista de verificación le ahorrará mucho estrés.