Qué es el error 504 Gateway Timeout: lo que he aprendido tras años gestionando servidores
Recuerdo perfectamente una madrugada de noviembre en la que, mientras supervisaba una tienda online que había montado años atrás con WordPress y PrestaShop, el tráfico se multiplicó por seis en cuestión de minutos. De pronto, los clientes empezaron a ver pantallas blancas con un número que hasta entonces solo había tratado en manuales: 504. No entendí del todo lo que pasaba hasta que fui al log de Nginx y vi el texto "upstream timed out" repetido una y otra vez. Desde aquella noche, he visto este error cientos de veces y he aprendido a reconocerlo casi al instante.
El error 504 Gateway Timeout, que en español se traduce como tiempo de espera de puerta de enlace agotado, es un código de estado HTTP que aparece cuando un servidor que actúa como puerta de enlace o proxy no recibe a tiempo la respuesta del servidor de origen del que depende para completar tu petición. Dicho de forma sencilla: tu solicitud llegó bien a la infraestructura del sitio, pero el servidor "upstream" —la máquina que realmente procesa lo que le pides— tardó demasiado en contestar. El gateway, cansado de esperar, corta la conexión y te devuelve ese molesto 504.
Un punto crucial que muchos usuarios no captan: el 504 es un error del lado del servidor. No hay nada roto en tu ordenador, en tu móvil ni en tu router. El problema está en la web que intentas visitar, y la responsabilidad de resolverla recae casi siempre en el administrador del sitio. Para ti como visitante significa que no puedes "arreglarlo" tú, pero también significa que tu equipo está en perfecto estado.
Para entenderlo mejor, hay que saber que cuando cargas una página web, tu petición casi nunca viaja en línea recta al servidor que aloja el contenido. Pasa por uno o varios servidores intermediarios —un proxy inverso, un balanceador de carga, un nodo perimetral de una CDN— que actúan como puertas de enlace. Ese gateway reenvía tu solicitud al servidor de origen y se queda esperando. Si el origen no contesta dentro del plazo configurado, el gateway se rinde. El número "504" viene simplemente del estándar HTTP que define este código para situaciones de timeout entre servidores.
En mis años trabajando en telecomunicaciones y gestionando canales de venta online, he comprobado que el mensaje exacto varía según el proveedor. Puedes toparnos con redacciones como "504 Gateway Timeout", "HTTP Error 504", "Gateway Timeout Error", la grafía característica de Nginx "504 Gateway Time-out" (con guion y minúscula), "Error 504" o incluso dentro de una página de estilo "mantenimiento" en WordPress. Todos significan exactamente lo mismo. Y ojo, los diseñadores web suelen personalizar esa página de error, así que el aspecto visual cambia de una web a otra.
Un matiz importante dentro del ecosistema Cloudflare: aparecen códigos equivalentes pero propios que conviene no mezclar. El error 521 indica que la conexión fue rechazada por el origen, y el 524 se muestra cuando el servidor acepta la conexión pero tarda más de 120 segundos en responder. Un 504 que ves en una página con la marca Cloudflare normalmente se originó en tu propio servidor de origen o en una puerta de enlace delante de él; el CDN solo lo reenvió. Y solo los planes Enterprise pueden ampliar el límite propio de Cloudflare.
He visto a compañeros confundir el 504 con otros códigos de la familia 50X, y distinguirlos acelera muchísimo el diagnóstico:
- 500 Internal Server Error: fallo interno genérico, sin categoría específica.
- 502 Bad Gateway: el origen sí respondió, pero con una respuesta inválida o mal formada.
- 503 Service Unavailable: el servidor está temporalmente no disponible, por sobrecarga o mantenimiento.
- 504 Gateway Timeout: el upstream no contestó dentro del plazo. En el 502 hubo respuesta (mala); en el 504, no hubo respuesta a tiempo.
En proyectos de comercio electrónico que he dirigido, esta diferenciación me ha ahorrado horas de depuración. Saber si el servidor respondió mal o simplemente no respondió cambia por completo la dirección en la que buscar el culpable.
Las causas del lado del servidor son las más frecuentes y abarcan un rango amplio: un servidor de alojamiento sobrecargado o con recursos insuficientes, consultas de base de datos lentas, scripts de larga duración que superan el tiempo límite, un timeout de PHP (a menudo por un plugin o tema pesado en WordPress), valores de tiempo de espera mal configurados en Nginx o Apache, reglas de firewall que bloquean la comunicación entre servidores, y nodos de CDN o proxy que no logran alcanzar el origen a tiempo.
También existen causas del lado del visitante, aunque son menos comunes: un pico momentáneo de red, un problema local de caché DNS, una caché de navegador corrupta o un proxy o VPN mal comportado. Estas posibilidades locales se descartan rápidamente probando el sitio desde otro dispositivo, otro navegador o una red distinta, por ejemplo los datos móviles del teléfono.
“En el 502 hubo respuesta (mala); en el 504 no hubo respuesta a tiempo. Esa distinción acelera el diagnóstico.”
Dato clave