Errore 504 Gateway Timeout: cause e soluzioni
L’errore 504 Gateway Timeout indica che un server che funziona da gateway o proxy non ha ricevuto in tempo la risposta necessaria da un altro servizio o server. Il problema può essere temporaneo oppure dipendere da uno script, dal database, da un servizio esterno o da un sovraccarico.
1. Ricarica la pagina dopo alcuni minuti
Un errore 504 occasionale può essere causato da un rallentamento temporaneo.
Attendi alcuni minuti e ricarica la pagina. Verifica inoltre se il problema riguarda:
- una sola pagina;
- l’intero sito;
- soltanto il pannello di amministrazione;
- un’operazione specifica, come un’importazione o un backup.
2. Controlla lo stato dei servizi
Verifica se sono presenti manutenzioni o problemi generali nella pagina Stato Server di Xlogic.
Se il problema coinvolge più siti o servizi dello stesso account, potrebbe non dipendere direttamente dall’applicazione.
3. Controlla l’utilizzo delle risorse
Accedi a cPanel e apri, se disponibile:
Metriche → Utilizzo risorse
Controlla eventuali superamenti relativi a:
- CPU;
- memoria;
- processi simultanei;
- I/O;
- IOPS.
L’interfaccia Utilizzo risorse è disponibile nei sistemi cPanel che utilizzano CloudLinux e il relativo plugin.
4. Controlla plugin e tema WordPress
Se l’errore è comparso dopo un aggiornamento o l’installazione di un componente, disattiva temporaneamente il plugin o il tema interessato.
Quando non puoi accedere alla bacheca, puoi rinominare la cartella del plugin tramite Gestione file:
wp-content/plugins/nome-plugin
Riattiva successivamente i componenti uno alla volta.
5. Verifica le operazioni pesanti
L’errore può comparire durante operazioni che richiedono molto tempo, per esempio:
- importazioni di prodotti;
- backup completi;
- scansioni di sicurezza;
- aggiornamenti massivi;
- elaborazione di immagini;
- chiamate verso API esterne;
- query lente al database.
Interrompi l’operazione e prova a eseguirla su una quantità inferiore di dati.
6. Controlla i registri degli errori
Consulta la sezione Errori di cPanel oppure il file error_log del sito.
Cerca riferimenti a:
- timeout;
- memoria esaurita;
- errori PHP;
- connessioni al database;
- plugin o script specifici;
- servizi esterni non raggiungibili.
7. Non aumentare arbitrariamente i timeout
Non aggiungere al file .htaccess configurazioni generiche per aumentare il timeout senza aver prima identificato la causa.
Un timeout più alto può nascondere temporaneamente il problema senza risolvere uno script lento, una query inefficiente o un servizio esterno non disponibile.
8. Contatta l’assistenza
Se l’errore continua, apri un ticket indicando:
- dominio interessato;
- URL che restituisce l’errore;
- data e ora approssimativa;
- operazione eseguita;
- frequenza del problema;
- messaggi presenti nel registro degli errori.
Queste informazioni permettono di controllare i log e le risorse utilizzate nel momento in cui si è verificato il timeout.