Error 504 Gateway Timeout: cómo identificar dónde se demora tu web

Actualizado hace 6 días

El error 504 Gateway Timeout indica que un servidor intermedio, como el proxy de Cloudflare, esperó la respuesta de otro servidor y no la recibió a tiempo. Para resolverlo, determiná primero si el error afecta a todos los visitantes o solo a tu conexión, si ocurre siempre o solo al hacer una acción concreta, y qué eslabón de la cadena se demoró: tu aplicación, PHP, el DNS o el propio intermediario.

Si solo estás visitando una web ajena, avisale a su administrador. Las pruebas y cambios de esta guía requieren acceso al sitio o al hosting.

Qué significa el error y dónde puede demorarse la respuesta

Cuando alguien abre tu web, la solicitud pasa por varios servidores en cadena: el navegador, el proxy de Cloudflare si el dominio lo usa, el servidor web y el proceso de PHP que ejecuta tu aplicación. Un 504 señala que uno de esos intermediarios (el gateway) no recibió a tiempo la respuesta del siguiente eslabón. Un 502 Bad Gateway, en cambio, significa que el gateway recibió una respuesta inválida: son fallas distintas, con su propia guía de diagnóstico.

Cada eslabón aplica su propio límite de espera. Cloudflare, por ejemplo, espera la respuesta del servidor de origen hasta 125 segundos por defecto y devuelve su propio código 524 al vencer ese plazo; los límites de PHP y del servidor web son independientes. Por eso el mismo síntoma puede venir de capas distintas, y el diagnóstico consiste en ubicar cuál se demoró.

Primero delimitá el problema

Guardá el mensaje completo del error antes de cambiar configuraciones: el código y la página donde aparece indican por dónde empezar.

Lo que observás	Por dónde empezar
Solo tu conexión recibe el 504	Navegador, caché y DNS local.
La página de error muestra el logotipo de Cloudflare	El servidor de origen no respondió a tiempo: revisá la aplicación.
El código es 524, no 504	Es el tiempo de espera propio de Cloudflare (125 segundos por defecto).
Todos reciben 504 tras cambiar DNS o migrar	Registro A o AAAA del dominio y estado del proxy.
El 504 aparece solo al guardar, importar o ejecutar una tarea	Tiempo de ejecución de PHP y rendimiento de la aplicación.
El 504 es intermitente y el sitio anda lento	Consumo de la cuenta y cuellos de botella de PHP.
El mensaje dice 503 o 508	No es un 504: es consumo de recursos (guía dedicada más abajo).

Solo tu conexión ve el 504

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.

Recargá la página con una recarga forzada: F5 o Ctrl + F5 en Windows, Cmd + R en Mac.
Probá en una ventana de incógnito. Si allí funciona, una extensión del navegador puede estar interviniendo.
Probá con otro navegador, otro dispositivo u otra conexión, por ejemplo datos móviles.
Vaciá la caché DNS de tu equipo: en Windows, ejecutá ipconfig /flushdns; en Mac, sudo killall -HUP mDNSResponder.
Si usás VPN, proxy o firewall propio, desactivalo momentáneamente para comparar el resultado.

La página de error muestra el logotipo de Cloudflare

Cuando la página de error lleva la marca de Cloudflare, el 504 lo devolvió el servidor de origen: Cloudflare actuó como intermediario y la falla está del lado del sitio, normalmente una aplicación que no respondió a tiempo. 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 el error solo aparece con el dominio proxado por Cloudflare y el sitio responde con normalidad cuando lo abrís sin pasar por el proxy, probá 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.

Si el código que ves es 524 a secas, no es un 504: Cloudflare conectó con tu servidor, pero este no devolvió ninguna respuesta antes del Proxy Read Timeout, cuyo valor por defecto es de 125 segundos (las zonas Enterprise de Cloudflare pueden elevarlo). En ese caso la aplicación se demoró más que el límite de Cloudflare, y las secciones de esta guía sobre acciones lentas y rendimiento de PHP aplican igual.

Todos reciben 504 tras cambiar DNS o migrar el sitio

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

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.
Si el valor es incorrecto, corregilo antes de esperar: la propagación no corrige un destino mal configurado.
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, como explicamos en cómo desactivar Cloudflare temporalmente.

El 504 aparece solo al guardar, importar o ejecutar una tarea

Guardar un cambio grande, importar o exportar contenido o ejecutar una actualización puede superar el tiempo de ejecución disponible aunque el sitio abra normalmente. Anotá qué acción exacta lo dispara y cuánto tarda antes de fallar: ese dato es el que necesitamos para ubicar la falla si necesitás contactarnos.

Revisá en cPanel el Uso de Recursos de la cuenta al momento de la falla. Los límites del plan producen los errores 503 y 508, no un 504, pero el consumo elevado indica si la tarea está saturando los recursos; consultá consumo de recursos y errores 503 – 508.
Si la tarea es un proceso de PHP, el límite max_execution_time puede quedarse corto para esa operación. Podés ajustarlo desde cPanel con la herramienta Seleccionar Versión PHP, en la pestaña Opciones, como explicamos en cómo cambiar la versión y configuración de PHP.
Para identificar qué demora la aplicación, usá PHP X-Ray, que rastrea plugins lentos, consultas de base de datos y llamadas externas; requiere que el servidor tenga CloudLinux OS Shared Pro. El procedimiento está en cómo usar PHP X-Ray.
Si la tarea forma parte de un plugin o tema de WordPress, actualizalo y repetí la acción; si el error empezó justo después de instalar o actualizar ese componente, es el sospechoso principal.

Si la tarea sigue fallando, enviános el caso con los datos de la última sección, indicando la acción exacta, la fecha y la hora en que se produce.

El 504 es intermitente y el sitio anda lento

Cuando el error aparece de forma intermitente y el sitio carga lento, conviene medir antes de cambiar configuración.

Revisá en cPanel el Uso de Recursos (Uso actual y DETALLES) para ver el consumo de CPU, RAM y procesos de la cuenta.
Si el sitio es WordPress, aplicá los pasos de qué hacer cuando notás lentitud en el acceso y, para identificar el componente que demora cada página, PHP X-Ray (requiere CloudLinux OS Shared Pro), como explicamos en cómo usar PHP X-Ray.
Si el 504 se concentra en una URL o una sección del sitio, anotá cuáles: ese patrón es el que permite ubicar el componente demorado.

No acumules cambios de DNS, PHP, plugins y seguridad al mismo tiempo para «hacerlo pasar». Aplicá un cambio por vez y verificá el resultado: así sabés qué resolvió el problema y qué lo empeoró. Y no envíes contraseñas por canales públicos.

Cómo comprobar que quedó resuelto

La comprobación debe repetir la misma solicitud que fallaba, desde la conexión o el navegador donde se producía el error.

Abrí la URL afectada y verificá que cargue sin el error.
Repetí la acción que lo disparaba, si el error ocurría al guardar o al enviar algo.
Probá otra página del sitio para confirmar que el resto funciona.
Revertí las excepciones temporales que ya no necesites, por ejemplo la pausa de Cloudflare, y registrá qué cambio resolvió el error.

Datos que necesitamos para ayudarte

Si el error persiste, abrí una consulta de soporte desde la mesa de clientes con estos datos para que podamos ubicar la falla:

Dominio y URL exacta, sin contraseñas ni tokens en los parámetros.
Captura o texto completo del error, con el código que muestra.
Fecha, hora y zona horaria del error, y el Ray ID si aparece.
Si usás Cloudflare, la salida de la ruta /cdn-cgi/trace del dominio (la abrís en el navegador y copiás lo que muestra).
Si afecta a todos los visitantes, solo a una conexión, solo a una acción o solo a través de Cloudflare.
Último cambio realizado en el sitio (DNS, PHP, plugins, temas) y pruebas que ya hiciste.

También podés escribirnos por WhatsApp o a [email protected]. Escribí desde la cuenta titular o con un contacto autorizado.

¿Te fue útil?