INICIO
tecnologia · solución de problemas
que es error 504 gateway timeout, Administrador IT frente a un monitor mostrando el error 504 Gateway Timeout en una web, con logs de servidor abiertos al fondo
tecnologia ·#6500 ·Lectura 9 min. · Redactor: Gonzalo E.Garcia

⚠️ Qué es el error 504 Gateway Timeout y cómo arreglarlo

Respuesta corta
Verificado
Redactado por Humanos!

El error 504 es siempre del lado del servidor: tu equipo está bien, el problema está en la web que visitas.

01

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
que es error 504 gateway timeout, Servidores en un data center mostrando sobrecarga de CPU y RAM, causa común del error 504 Gateway Timeout
Imagen

Servidores en un data center mostrando sobrecarga de CPU y RAM, causa común del error 504 Gateway Timeout

02

De qué se trata realmente este código de estado HTTP

En mi faceta más operativa, la que compartí con equipos de arquitectura IT en grandes operadores de comunicaciones, aprendí que un 504 recurrente no es un incidente menor. Es una señal de alarma que, si se ignora, erosiona la confianza del usuario y golpea directamente los ingresos. He visto tiendas perder clientes irrecuperables porque cada viernes por la tarde aparecía ese código en la pasarela de pago.


Personalmente, una de las causas que más me ha costado detectar y que es fácil de pasar por alto es el agotamiento de los workers o procesos de aplicación. Las configuraciones modernas no procesan peticiones con capacidad ilimitada: usan un grupo fijo de trabajadores. Si todos están ocupados, las nuevas solicitudes entran en cola y, si esperan más que el timeout de la puerta de enlace, el resultado es un 504. Es una causa típica en sitios concurridos y resulta engañosa porque cada petición individual puede ser rápida: simplemente no hay suficientes trabajadores para todas. En PHP con PHP-FPM el límite lo marca pm.max_children en la configuración del pool; si el log muestra mensajes del tipo "server reached pm.max_children", ahí está el culpable.


Cada worker consume memoria, así que no conviene subir el valor por encima de lo que permita la RAM. En aplicaciones Node.js el equivalente es un proceso bloqueado o un pool de trabajadores saturado: una sola operación síncrona larga puede paralizar el event loop y hacer que todas las peticiones posteriores agoten el tiempo de espera. La solución pasa por ejecutar varias instancias, por ejemplo con un gestor de procesos como PM2 en modo cluster, y mover el trabajo pesado fuera del hilo principal. El principio es idéntico al de los timeouts: más trabajadores dan más capacidad, pero si las peticiones son lentas por culpa del código o de la base de datos, el arreglo real está aguas arriba.


Los síntomas ayudan a identificar la causa concreta. Te dejo una tabla que me hubiera gustado tener en mis primeras guardias:

Síntoma observableCausa probable
Error durante picos de tráfico, CPU y RAM cerca del límiteServidor sobrecargado
Falla en una página o acción concreta (importación, checkout)Consulta lenta o script largo
Error a un tiempo constante, por ejemplo a los 30 o 60 sTimeout demasiado corto
Aparece justo tras instalar o actualizar un pluginPlugin o tema pesado en WordPress
Página con la marca del proveedor CDNProblema de CDN o proxy
Solo te afecta a ti, funciona desde otro dispositivoRed, DNS o VPN local

Para el visitante, las comprobaciones rápidas que siempre recomiendo son:

  • Recargar tras esperar un momento (Ctrl+R en Windows/Linux, Cmd+R en Mac). El 504 suele ser temporal.
  • Probar otro navegador, ventana de incógnito u otro dispositivo para descartar extensiones o caché.
  • Limpiar la caché del navegador y vaciar la caché DNS.
  • Reiniciar router y módem, apagándolos unos 30 segundos, y desactivar temporalmente VPN o proxy.

Vaciar la caché DNS se hace con comandos concretos: en Windows, ipconfig /flushdns desde el Símbolo del sistema; en macOS, sudo dscacheutil -flushcache y sudo killall -HUP mDNSResponder desde Terminal; en Linux, systemctl restart systemd-resolved.service o sudo systemctl restart nscd. Chrome mantiene además su propia caché DNS, que se limpia desde chrome://net-internals/#dns pulsando "Clear host cache". Si el sitio ha cambiado de IP recientemente, puede ser necesario esperar hasta 48 horas a que termine la propagación DNS.


A mí me sirve mucho comprobar si el sitio está caído para todo el mundo usando servicios como DownDetector o isitdownrightnow.com. Si el informe dice que está caído para todos, no queda más remedio que esperar. Y una advertencia práctica que he aprendido a golpes: si el error aparece mientras estás realizando un pago, no recargues sin pensar, porque podrías acabar pagando dos veces. Vigila siempre el extracto bancario.


Para el propietario del sitio, el orden de diagnóstico que sigo es: revisar uso de recursos (CPU y RAM), aumentar timeouts en Nginx (proxy_connect_timeout, proxy_send_timeout, proxy_read_timeout, fastcgi_read_timeout) o Apache (Timeout, ProxyTimeout), elevar max_execution_time en php.ini (nunca a 0, porque permitiría scripts infinitos), revisar consultas lentas con el slow-query log, auditar llamadas a APIs externas y revisar reglas de firewall que bloqueen peticiones internas.


En WordPress hay culpables adicionales muy frecuentes. La técnica clásica es desactivar todos los plugins —si no puedes acceder al panel, renombra la carpeta wp-content/plugins por FTP— y reactivarlos uno a uno. Si no son los plugins, prueba con un tema por defecto. Y activa el modo depuración añadiendo en wp-config.php: define('WP_DEBUG', true); define('WP_DEBUG_LOG', true); define('WP_DEBUG_DISPLAY', false);. Los registros en Nginx (/var/log/nginx/error.log con "upstream timed out"), PHP-FPM ("server reached pm.max_children") y Apache (/var/log/apache2/error.log) suelen revelar la causa. También vigila el tráfico: ataques de spam, bots o DDoS pueden saturar el servidor. Desactivar temporalmente la CDN es una prueba diagnóstica válida, aunque ten en cuenta que puede implicar cambios de DNS que tardan en propagarse.

Conclusión:

¿que es error 504 gateway timeout?

Si me preguntas a mí, con tantos años moviendo servidores y gestionando crisis de infraestructura, te diría que subir los valores de timeout suele ser el arreglo equivocado. Un tiempo de espera mayor trata el síntoma, no la causa: solo consigue que la puerta de enlace espere más una respuesta que sigue siendo demasiado lenta. Yo creo que, en nueve de cada diez casos, lo que de verdad está pasando es que el upstream es lento por una consulta de base de datos pesada, un patrón N+1, una API externa que se cuelga o una tarea que debería ir como trabajo en segundo plano. Si una página normal necesita 300 segundos de timeout, eso es una señal clara para optimizar código, no para esperar más. Es complicado dar una sola respuesta porque el 504 tiene varias causas posibles, pero si atacas la causa raíz en vez del síntoma, el problema desaparece para siempre.

Fuentes: 1º Copahost.com, 2º Hostinger.com, 3º Geeksforgeeks.org, 4º Howtogeek.com
IMAGEN1-AUTOR:Nexuscurioso|Licencia:Todos los derechos reservados|Url:---
IMAGEN2-AUTOR:Nexuscurioso|Licencia:Todos los derechos reservados|Url:---
Redacción: Gonzalo E.Garcia · Actualizado en: 14/11/2026
Valoración para Respuesta Valoración para Respuesta Valoración para Respuesta Valoración para Respuesta Valoración para Respuesta Valoración para Respuesta Valoración para Respuesta Valoración para Respuesta Valoración para Respuesta Valoración para Respuesta
4.4 / 5 · 55 valoraciones Valorar

¿Tienes algo que aportar? Envíanos tu respuesta

¿Qué es el Error 504 Gateway Timeout? ¿Qué es el Error 504 Gateway Timeout? Qué es el error 502 Bad Gateway y cómo solucionarlo Qué es el error 502 Bad Gateway y cómo solucionarlo
¿Quieres ver más respuestas sobre que es error 504 gateway timeout?