L'errore 524 A Timeout Occurred indica che la connessione TCP tra Cloudflare e il server di origine e avvenuta con successo, ma il server web non ha inviato una risposta HTTP valida entro 100 secondi. E il classico errore generato da script backend lenti, esportazioni di database pesanti, upload di file di grandi dimensioni o query SQL bloccanti.
Per risolverlo in modo architetturale:
- Sposta i task computazionali lunghi su worker asincroni in background (con code Celery, Redis o cron job) e rispondi subito al client con un identificativo per verificare lo stato
- Se il processo deve rimanere sincrono, usa HTTP Server-Sent Events (SSE) o streaming HTTP per inviare frammenti di dati prima dei 100 secondi, mantenendo viva la connessione
- Nei piani Cloudflare Enterprise e possibile estendere questo timeout fino a 6000 secondi, ma la soluzione corretta resta il disaccoppiamento asincrono del backend.