Error 502 Bad Gateway: cómo identificar la causa y resolverlo

Si el sitio funciona para otros visitantes, el problema está en tu equipo, tu red o tu resolución de DNS, no en el servidor.

1. Recargá la página con una recarga forzada: F5 o Ctrl + F5 en Windows, Cmd + R en Mac.

2. Probá en una ventana de incógnito. Si allí funciona, una extensión del navegador puede estar interviniendo.

3. Probá con otro navegador, otro dispositivo u otra conexión, por ejemplo datos móviles.

4. Vacíá la caché DNS de tu equipo: en Windows, ejecutá ipconfig /flushdns; en Mac, sudo killall -HUP mDNSResponder.

5. Si usás VPN, proxy o firewall propio, desactivalo momentáneamente para comparar el resultado.

Cuando la página de error lleva la marca de Cloudflare, el error 502 lo devolvió el servidor de origen: Cloudflare actuó como intermediario y la falla está del lado del sitio. Si la página no lleva la marca, el error puede haberlo generado Cloudflare misma.

En ambos casos, copiá el Ray ID y la hora exacta del error: son los datos que permiten ubicar la solicitud. Si no hay marca, Cloudflare sugiere probar desactivando la compresión en el origen para descartar una respuesta comprimida dañada; ese ajuste lo hacemos nosotros, así que envianos el caso con la información de la última sección.

Si el código que ves es un 520 a 526, no es un 502: cada código de ese rango describe una falla distinta entre Cloudflare y tu servidor.

Un dominio que apunta a un destino equivocado puede devolver errores de gateway en lugar de mostrar el sitio.

1. Comprobá que el registro A o AAAA del dominio apunte al valor esperado. Tené en cuenta que, con el proxy de Cloudflare activado, las consultas públicas pueden devolver IPs de Cloudflare; consultá cómo comprobar un cambio de DNS.

2. Si el valor es incorrecto, corregilo antes de esperar: la propagación no corrige un destino mal configurado.

3. Si el sitio usa Cloudflare, podés probar con Pause Cloudflare on Site, que pausa el proxy y envía el tráfico directamente al servidor. No uses Development Mode como prueba: suspende la caché, pero deja activos el WAF, las reglas y el SSL/TLS. Los dos controles están explicados en cómo desactivar Cloudflare temporalmente.

Un plugin o un tema defectuoso puede hacer fallar el proceso de PHP y provocar un 502. El error también puede aparecer durante una operación puntual, como instalar WordPress o descargar su paquete de idioma, y no solo al abrir la portada.

1. Revisá el registro de errores del sitio en busca de un error fatal: una ruta bajo wp-content/plugins/ o wp-content/themes/ señala el componente a investigar.

2. Si no podés entrar al escritorio de WordPress, entrá al Administrador de archivos de cPanel y renombrá wp-content/plugins a plugins-disable. Si el sitio vuelve, renombrá la carpeta a su nombre original y reactivá los plugins de a uno hasta identificar el responsable.

3. Si el sospechoso es el tema, activá temporalmente un tema predeterminado de WordPress.

4. Si el problema empezó al editar el archivo .htaccess, recuperá la copia previa del archivo; si no tenés copia, comparalo con el contenido por defecto de .htaccess de WordPress.

Si el error persiste con todos los plugins desactivados y el tema por defecto, enviános el caso con los datos de la última sección.

Si los errores comenzaron después de un cambio de versión de PHP, es probable que un plugin o tema no sea compatible con la nueva versión. Actualizá el plugin o tema afectado, o volvé temporalmente a la versión anterior desde cPanel con la herramienta Seleccionar Versión PHP, como explicamos en cómo cambiar la versión y configuración de PHP.

PHP 8.4 está disponible en todos nuestros planes de hosting y la versión por defecto es la 8.2. Para sitios nuevos o actualizados, sugerimos PHP 8.3 o superior.

Guardar un cambio grande, importar contenido o ejecutar una actualización puede superar el tiempo de respuesta disponible aunque el sitio abra normalmente. En esos casos el diagnóstico depende de los registros del servidor, así que reuní la información de la última sección y envianos el caso: indicá la acción exacta, la fecha y la hora en que se produce.

Un 502 no es el mismo error que un 503 o 508 por límites del plan. Si el mensaje dice 503 Service Unavailable o 508 Resource Limit Is Reached, seguí la guía de consumo de recursos y errores 503 – 508.