Error 504 Gateway Timeout: qué significa y cómo solucionarlo

El error 504 Gateway Timeout aparece cuando un servidor intermedio (un proxy, el balanceador del hosting o Cloudflare) esperó la respuesta de tu servidor principal y se cansó de esperar. Tu sitio no está apagado del todo: está tardando demasiado en contestar.

En qué se diferencia de otros errores

504: el servidor de atrás responde, pero tarde. Pasa con consultas lentas, procesos colgados o picos de visitas.
502 Bad Gateway: el servidor de atrás respondió algo inválido o se cortó.
503 Service Unavailable: el servidor dice que está saturado o en mantenimiento.
Cloudflare 524: es el mismo problema que el 504 pero visto desde Cloudflare, que corta a los 100 segundos.

Primero, fijate si es tu sitio o tu conexión

Recargá la página después de un minuto: muchos 504 son picos que se pasan solos.
Probá desde el celular con datos móviles o con el chequeo gratis de Vigía.
Si pasa en una sola página (por ejemplo, al exportar pedidos o generar un informe), el problema es esa tarea pesada, no todo el sitio.

Cómo solucionarlo

Hosting compartido: revisá en el panel si llegás al límite de CPU o procesos y abrí un ticket con soporte. Pediles que revisen los registros de "timeout" de tu cuenta.
WordPress: desactivá plugins pesados (de copias de seguridad, estadísticas o importación) renombrando su carpeta en wp-content/plugins. Las copias de seguridad programadas a la misma hora que el error son sospechosas.
Base de datos lenta: tablas enormes o sin optimizar hacen que cada página tarde. Un plugin como WP-Optimize ayuda; en un VPS revisá el registro de consultas lentas de MySQL.
Servidor propio con Nginx y PHP-FPM: revisá que PHP-FPM esté corriendo (systemctl status php8.2-fpm, según tu versión) y que no se quede sin procesos libres. Subir fastcgi_read_timeout esconde el síntoma; lo correcto es encontrar lo que tarda.
Pocos recursos: si el servidor se queda sin memoria en los picos, ver página web lenta y evaluá un plan con más recursos.

Enterate cuando empieza

Los 504 suelen aparecer de a ratos antes de que el sitio se caiga del todo. Vigía revisa tu sitio cada pocos minutos y te manda un Telegram cuando deja de responder bien, y otro cuando vuelve. Gratis para 2 sitios.

¿Tu sitio está bien ahora?

O directamente probá Vigía gratis: te avisa por Telegram si se cae, y antes de que venzan el SSL y el dominio.