504 Gateway Timeout — Tiempo de espera de pasarela agotado en Nginx

Qué causa este error

El servidor upstream no respondió dentro del periodo de proxy_read_timeout (por defecto 60 s). Es posible que el backend esté sobrecargado o bloqueado.

Cómo solucionarlo

Aumenta proxy_read_timeout. Optimiza el tiempo de respuesta del upstream. Añade caché para endpoints lentos. Verifica el estado del backend.

# Increase proxy timeout
proxy_connect_timeout 300;
proxy_send_timeout 300;
proxy_read_timeout 300;