Il sito mostra errori 502 o 504: cause e controlli

Distinguere 502 e 504 senza attribuire subito la colpa

Secondo la documentazione HTTP, 502 Bad Gateway indica che un sistema intermedio ha ricevuto una risposta non valida dal servizio a cui si appoggiava. 504 Gateway Timeout indica invece che la risposta necessaria non è arrivata entro il tempo previsto.

Il sistema intermedio può essere un servizio davanti al sito o un componente dell’infrastruttura dell’hosting. Il logo mostrato nella pagina di errore non dimostra da solo chi abbia causato il guasto. Chiedi a chi gestisce il sito di descrivere i passaggi essenziali della richiesta. Serve capire quale componente ha prodotto il codice e da quale altro sistema attendeva una risposta, senza trasformare il messaggio in una diagnosi automatica.

Conservare pochi elementi utili prima che l’errore sparisca

Annota l’indirizzo completo, l’ora con il fuso, il codice e l’azione svolta. Se la pagina mostra un identificativo della richiesta, conservalo insieme a una schermata priva di dati riservati. Specifica se eri autenticato e se il problema si ripeteva o si è verificato una sola volta.

La documentazione Cloudflare sui 502 e 504, quando quel servizio è presente, richiede elementi precisi per l’assistenza. Altri fornitori possono chiedere informazioni differenti. Invia una sequenza breve e riproducibile al referente del sito, che potrà raccogliere i dettagli tecnici necessari. Non pubblicare registri completi in un canale aperto: possono contenere indirizzi, parametri o informazioni di sessione non utili alla segnalazione pubblica.

Capire se fallisce tutto il sito o una singola operazione

Confronta homepage, una pagina interna e il percorso segnalato. La homepage può essere disponibile da una copia in cache mentre una ricerca o un’area clienti richiede una risposta nuova dal server. Il fatto che una pagina si apra non esclude quindi un problema operativo.

La tabella orienta l’indagine, non assegna una causa certa. Mantieni separati casi con sintomi diversi: una ricerca lenta e un’interruzione generale potrebbero richiedere interventi distinti.

Far confrontare i registri dello stesso tentativo

Il tecnico deve cercare lo stesso intervallo nei registri del sistema intermedio, del server e dell’applicazione. Verifica se la richiesta è arrivata, se l’elaborazione è iniziata e dove si interrompe. Orari allineati e identificativi aiutano a evitare che due fornitori analizzino tentativi diversi.

Tra le piste da valutare ci sono servizi riavviati, connessioni interrotte, risorse esaurite e risposte tardive di integrazioni esterne. Vanno controllate attraverso evidenze, non applicando in sequenza tutte le soluzioni trovate online. Se il difetto segue una pubblicazione, confronta configurazione e modifiche recenti. Se precede l’errore un’attesa crescente, la guida alla risposta lenta del server aiuta a distinguere i tempi iniziali dalle fasi successive. Conserva l’esito di ogni verifica.

Ripristinare il servizio intervenendo sul passaggio accertato

Aumentare un tempo limite può cambiare il sintomo senza eliminare il lavoro che si blocca. Prima chiarisci se l’operazione dovrebbe concludersi rapidamente o se sta svolgendo un’attività lunga che richiede un’organizzazione diversa. Anche aumentare il piano hosting ha senso solo se le risorse disponibili sono il limite osservato.

Concorda un intervento circoscritto e una modalità di ritorno alla configurazione precedente. Può essere necessario correggere un’integrazione, recuperare un servizio o annullare una modifica recente: la scelta dipende dall’analisi. Evita di disattivare protezioni o instradamenti alla cieca per tentare l’accesso diretto al server. Durante il ripristino, indica ai clienti un recapito funzionante se la parte commerciale resta indisponibile. Chi gestisce le richieste deve sapere quali operazioni sono affidabili.

Controllare ordini e richieste prima di ripetere l’azione

Una schermata di timeout non dimostra che l’operazione sul server sia stata annullata. Un ordine o una richiesta potrebbero essere stati registrati senza che il browser abbia ricevuto la conferma. Prima di ripetere un pagamento, verifica lo stato nel negozio e presso il gestore del pagamento attraverso i referenti autorizzati.

Per i moduli, cerca la richiesta nel sistema destinatario con i dati di prova o con il riferimento concordato. Il percorso deve distinguere operazione in attesa, fallita e conclusa, senza invitare automaticamente a premere di nuovo. Se il pagamento risulta effettuato ma manca l’ordine, usa la guida al pagamento riuscito con ordine assente. Il ripristino tecnico e la riconciliazione delle operazioni coinvolte sono due attività complementari, entrambe necessarie.

Verificare il percorso ripristinato e registrare la causa

Ripeti la stessa operazione che falliva, con un test concordato, e controlla sia la risposta della pagina sia l’esito nel sistema. Se il guasto compariva sotto carico o in una fascia precisa, una prova isolata in un momento tranquillo non chiude tutta la verifica: osserva anche la condizione che lo faceva emergere.

Consegna un rapporto breve con intervallo del disservizio, componenti coinvolti, causa accertata, modifica applicata e controlli successivi. Quando la causa non è ancora dimostrata, scrivilo chiaramente invece di attribuire il ripristino all’ultimo riavvio. Valuta i controlli automatici dei percorsi importanti per rilevare una ricaduta. Il risultato va misurato sulle funzioni utilizzabili dai clienti, non soltanto sull’assenza del codice nella homepage.

Domande frequenti

Un errore 504 si risolve aumentando il timeout?

Solo in alcune configurazioni può essere parte della soluzione. Prima bisogna capire perché la risposta tarda e quale passaggio scade. Attendere più a lungo non elimina un blocco, un’elaborazione inefficiente o un servizio indisponibile.

Il logo della CDN significa che il problema è della CDN?

Non necessariamente. La pagina può essere mostrata dal sistema che rileva il guasto, mentre la causa si trova altrove. Individua chi produce il codice e confronta i registri dei passaggi coinvolti.

Posso ripetere subito un pagamento dopo un 502 o 504?

Prima verifica l’esito dell’operazione: la mancata conferma nel browser non prova che il pagamento o l’ordine non siano stati registrati. Usa i riferimenti della transazione e coordina il controllo con il negozio e il gestore del pagamento.