Qué significa
Un gateway o proxy no recibió a tiempo la respuesta del servidor upstream.
Causas habituales
- Consultas a base de datos o llamadas a APIs externas lentas
- Tiempo de espera del proxy menor que el de procesamiento
- Servidor upstream inaccesible por problemas de red
Cómo solucionarlo
Si eres el cliente o visitante
Reintenta más tarde; para operaciones largas, pregunta si la API ofrece procesamiento asíncrono.
Si administras el sitio o la API
Acelera la ruta lenta o pásala a un trabajo en segundo plano; sube los tiempos del proxy (proxy_read_timeout) solo a valores realistas.
Respuesta de ejemplo
HTTP/1.1
HTTP/1.1 504 Gateway Timeout
Date: Tue, 07 Oct 2025 09:30:00 GMT
Server: nginx
Content-Length: 0Especificación
Preguntas frecuentes
› ¿Cómo arreglo un 504 Gateway Timeout en nginx?
Averigua por qué el upstream es lento; si se esperan peticiones largas, sube proxy_read_timeout y el tiempo de espera del servidor de la app a la vez.
› ¿Quién devuelve el 504, mi app o el proxy?
El proxy, balanceador o CDN que está delante de tu app, tras esperarla demasiado.