HTTP 504 Gateway Timeout
Código de estado 504 · Clase 5xx
Mensaje oficial (tal como aparece en pantalla): Gateway Timeout
También se busca como: error 504, HTTP 504, 504 gateway timeout, gateway time-out
Qué significa
504 Gateway Timeout significa que una pasarela o proxy esperó demasiado la respuesta del servidor ascendente (upstream) y se rindió. La parte frontal es accesible, pero la aplicación que hay detrás es demasiado lenta o se ha quedado atascada en una tarea larga, como una consulta pesada a la base de datos.
Se aplica a: Todos los navegadores, nginx, Apache, Cloudflare, AWS ALB
Cómo solucionar HTTP 504 Gateway Timeout
- Recarga la página pasado un minuto; los picos de carga temporales suelen resolverse solos
- Prueba con otra red para descartar un proxy de tu lado
- En informes o exportaciones largos, usa un intervalo de fechas menor o la opción de exportación en segundo plano del sitio
- Si eres el propietario del sitio: localiza las solicitudes lentas en los registros de la aplicación y en el APM, y optimiza la consulta lenta o la llamada a la API externa
- Si eres el propietario del sitio: alinea los tiempos de espera para que cada capa espere un poco más que la que tiene detrás (en nginx 'proxy_read_timeout' o 'fastcgi_read_timeout')
- Si eres el propietario del sitio: traslada el trabajo de larga duración a tareas en segundo plano y responde rápido al cliente
- Si eres el propietario del sitio detrás de una CDN: recuerda que la CDN tiene su propio tiempo de espera hacia el origen (Cloudflare muestra su propia página 524 cuando el origen es demasiado lento)
Por qué ocurre
El servidor ascendente no respondió dentro del tiempo de espera del proxy. Son habituales las consultas lentas a la base de datos, las tablas bloqueadas, los workers sobrecargados, las llamadas a API externas que se quedan colgadas y los tiempos de espera demasiado bajos para tareas largas legítimas.
Preguntas frecuentes
¿Puedo solucionar un 504 Gateway Timeout como visitante?
Normalmente no; el servidor del sitio es demasiado lento. Esperar y reintentar es la principal opción.
¿Debería simplemente aumentar el tiempo de espera?
Solo como medida provisional. Encuentra y corrige la operación lenta, o trasládala a una tarea en segundo plano.
Errores relacionados
Fuente: IANA HTTP Status Code Registry · soluciones redactadas y revisadas por los editores (consulta nuestra política editorial)
Última actualización: