Error 504 Gateway Timeout: cómo solucionarlo
Por qué tu servidor tarda demasiado y cómo arreglar el 504.
El «504 Gateway Timeout» aparece cuando el servidor tarda demasiado en responder y se agota el tiempo de espera. Es primo hermano del 502, pero aquí el problema es de lentitud, no de respuesta inválida.
Qué es el error 504
El 504 (Gateway Timeout) es un código de estado HTTP que indica un problema en la comunicación con el servidor. No es un fallo de tu navegador ni de tu ordenador: el origen está en el servidor o en la infraestructura que hay delante de tu web (proxy o balanceador).
El 504 y el 502 Bad Gateway se confunden, pero son distintos: en el 502 el backend responde algo inválido; en el 504 no responde a tiempo. Por eso el 504 casi siempre apunta a lentitud —una consulta pesada, un proceso largo o una API externa que se demora— más que a una caída seca.
Por qué aparece
Rara vez hay una única causa. Estas son las más habituales y cómo se resuelven cada una:
Causas y soluciones
| Causa probable | Cómo se soluciona |
|---|---|
| Consulta o proceso muy lento | Optimiza la consulta a base de datos o el proceso que se cuelga. |
| Timeout demasiado bajo | Sube los tiempos de espera de NGINX/proxy y PHP. |
| Backend saturado | Amplía recursos: PHP se queda sin capacidad para responder a tiempo. |
| API externa lenta | Cachea la respuesta o ponle un timeout controlado. |
Cómo solucionarlo
Ve de lo más simple a lo más profundo; en la mayoría de casos el problema se resuelve en los primeros pasos:
Solución del 504
- 1
Reintenta y observa
Si es puntual, puede ser un proceso concreto que tardó.
- 2
Revisa los logs de servidor
Localiza qué petición está agotando el tiempo.
- 3
Optimiza lo lento
Consultas pesadas, crons o llamadas a APIs externas.
- 4
Sube los timeouts con criterio
Da margen, pero sin tapar un problema de fondo.
- 5
Amplía recursos si se repite
Un backend con más músculo responde a tiempo.
Cómo prevenirlo
Más vale que no vuelva. Estas medidas evitan que el 504 reaparezca:
Para que el 504 no vuelva
- Optimiza consultas y procesos lentos de tu web.
- Ejecuta las tareas largas por consola, no por web.
- Cachea o controla el tiempo de las APIs externas.
- Ten recursos suficientes para responder a tiempo en los picos.
Preguntas frecuentes
¿En qué se diferencia del 502?
El 502 es una respuesta inválida del backend; el 504 es que el backend no respondió a tiempo. Uno es «respondió mal», el otro «tardó demasiado».
¿Por qué me sale al importar o hacer copias?
Procesos largos pueden superar el timeout. Conviene ejecutarlos por consola o con más tiempo y recursos.
¿Cómo lo evito?
Optimizando lo lento y con un servidor que no se sature. Un VPS gestionado ajusta timeouts y recursos por ti.
Si tu servidor tarda tanto que salta el 504, necesita más músculo o afinado. Un VPS gestionado optimiza recursos y timeouts, y si el fondo es lentitud te ayudará acelerar tu WordPress. Cuéntanos tu caso.
Artículos relacionados
Qué es un VPS y para qué sirve
Qué es un VPS, cómo funciona, cuánto cuesta y cuándo dar el salto desde un compartido.
Leer Servidores y DevOpsError 502 Bad Gateway: cómo solucionarlo
Qué es el 502 Bad Gateway, por qué aparece y cómo solucionarlo.
Leer Servidores y DevOpsError 503 Service Unavailable: solución
Por qué tu web se satura y da 503, y cómo evitarlo escalando el servidor.
Leer Servidores y DevOpsError 429 Too Many Requests: solución
Qué es el 429, por qué tu web lo lanza y cómo solucionarlo.
Leer Servidores y DevOpsError 504 Gateway Timeout: cómo solucionarlo
Por qué tu servidor tarda demasiado y cómo arreglar el 504.
Leer Servidores y DevOpsVPS barato: por qué el más barato sale caro
Qué incluye (y qué no) un VPS barato, el coste oculto de gestionarlo tú y cuándo compensa un VPS gestionado.
Leer Servidores y DevOpsVPS gratis: opciones reales y sus límites
Dónde conseguir un VPS gratis, el truco de las capas gratuitas y cuándo conviene un VPS gestionado.
Leer Servidores y DevOpsQué es un servidor dedicado y cuándo lo necesitas
Qué es un servidor dedicado, en qué se diferencia de un VPS y del compartido, y cuándo compensa frente a un VPS gestionado.
Leer Servidores y DevOpsError 404 Not Found: qué es y cómo solucionarlo
Qué significa el error 404, por qué aparece, cómo arreglarlo y cómo evitar que perjudique tu SEO.
Leer Servidores y DevOpsError 400 Bad Request: causas y solución
Por qué el servidor no entiende tu petición (cookies, URL, cabeceras) y cómo solucionar el 400 rápido.
Leer Servidores y DevOpsError 405 Method Not Allowed: cómo solucionarlo
Por qué el servidor rechaza el método de la petición y cómo arreglar el 405 en formularios y API.
Leer¿Tu web te está dando este problema?
Pásate a un VPS gestionado y olvídate. Migración gratis y sin cortes.