502 Bad Gateway: guida alla diagnosi per livelli

Che cos’è un errore 502 Bad Gateway, quali sono le cause comuni a monte e nel proxy, come lo gestisce Googlebot e quale impatto ha su scansione e indicizzazione.

Prima pubblicazione: 28 giu 2026 · Ultimo aggiornamento: 6 ago 2026 · Advanced
Lingue
1 segnale di evidenza in questa pagina

Un 502 Bad Gateway significa che un proxy o gateway davanti al sito (CDN, load balancer o reverse proxy) ha ricevuto una risposta non valida dal server d’origine. È un problema d’infrastruttura, non di Search Console. La documentazione di Google raggruppa 502 con 500 e 503 nello stesso trattamento 5xx: la scansione rallenta in proporzione al numero di URL in errore, i contenuti delle risposte 5xx vengono ignorati e le pagine vengono rimosse dall’indice se gli errori persistono. Google non pubblica una soglia di durata sicura specifica né una garanzia di recupero automatico, quindi un picco breve comporta un rischio pratico molto inferiore rispetto a un errore che continua a ripresentarsi, ma non è ufficialmente privo di rischio. Diagnostica per livello (CDN, reverse proxy, origine) e correla branding o pagine di errore con header, trace ID e log invece di fidarti solo della pagina d’errore.

TL;DR — Un 502 è un errore del livello proxy/gateway: RFC 9110 §15.6.3 lo definisce come un gateway o proxy che riceve una risposta non valida da un server a monte. È distinto da 500 (errore dell’applicazione d’origine) e 503 (origine deliberatamente non disponibile). La documentazione di Google raggruppa 500, 502 e 503 nello stesso trattamento 5xx: la frequenza di scansione diminuisce in proporzione al numero di URL in errore, i contenuti delle risposte 5xx vengono ignorati e gli errori persistenti rimuovono le pagine dall’indice. Il recupero è graduale quando tornano le risposte 2xx, anche se Google non pubblica una tempistica fissa. La durata conta, ma non esiste una soglia ufficiale: i picchi brevi comportano un rischio pratico molto inferiore, mentre gli errori che continuano a ripresentarsi sono quelli che mettono davvero a rischio le pagine — le osservazioni di Mueller del novembre 2025 lo collocano informalmente nell’ordine di più giorni, non come SLA documentato. Diagnostica per livello — CDN, reverse proxy o origine — e correla le prove tra gli hop invece di fidarti solo di una pagina di errore personalizzata.

Che cosa segnala davvero un 502

RFC 9110 §15.6.3 definisce nello specifico 502 come un gateway o proxy che riceve una risposta non valida da un server in ingresso raggiunto mentre cercava di soddisfare la richiesta. Questo confine della specifica è importante: identifica il punto in cui il gateway ha osservato il fallimento, non necessariamente l’hop che lo ha causato. Lo stato 502 è una prova di un errore di confine, non la prova che l’applicazione d’origine sia rotta. È la distinzione che la maggior parte degli articoli concorrenti sulle “13 modi per risolvere il problema” sfuma, ed è il motivo per cui la diagnosi seguente è stratificata e non piatta. Evidence for this claim A 502 response means a gateway or proxy received an invalid response from an upstream server. Scope: RFC 9110 defines the gateway response semantics; it does not identify which infrastructure layer caused a specific failure. Confidence: high · Verified: IETF: RFC 9110 §15.6.3 — 502 Bad Gateway

Confronta i codici 5xx che si confondono facilmente:

  • 500 Internal Server Error — l’applicazione d’origine è andata in errore (bug del codice, eccezione non gestita, esaurimento delle risorse). L’origine ha risposto e la risposta è stata: “mi sono rotto”.
  • 502 Bad Gateway — il proxy ha ricevuto una risposta malformata o non valida dal server a monte (RFC 9110 §15.6.3).
  • 503 Service Unavailable — l’origine è deliberatamente non disponibile; è il codice intenzionale, autorizzato da Google, di “torna più tardi” per la manutenzione pianificata, idealmente con un header Retry-After.
  • 504 Gateway Timeout — il proxy ha atteso il server a monte e non ha ricevuto nulla prima della scadenza del timeout (RFC 9110 §15.6.5). (502 = risposta errata; 504 = nessuna risposta in tempo.)
Evidence for this claim A 502 response means a gateway or proxy received an invalid response from an upstream server. Scope: RFC 9110 defines the gateway response semantics; it does not identify which infrastructure layer caused a specific failure. Confidence: high · Verified: IETF: RFC 9110 §15.6.3 — 502 Bad Gateway

La conseguenza pratica è questa: 503 è il codice che scegli intenzionalmente; 502 è il codice che ti capita quando l’infrastruttura fallisce.

Come gestisce Googlebot un 502

Ecco la parte da ancorare alla documentazione reale di Google, invece della formula vaga “può danneggiare il ranking” che si legge altrove. Il documento Google sugli errori HTTP e di rete elenca 502 (bad gateway) tra i codici 5xx e assegna a tutti i codici 5xx lo stesso trattamento:

  • La frequenza di scansione diminuisce proporzionalmente. Google riduce la frequenza di scansione del sito e la riduzione è proporzionale al numero di singoli URL che restituiscono un errore del server. Pochi 502 hanno un impatto minore; un 502 sull’intero sito è un chiaro “rallenta”.
  • I contenuti 5xx vengono ignorati. Qualsiasi contenuto ricevuto da un URL che restituisce 5xx viene ignorato: Google non indicizzerà una pagina di errore 502 come contenuto del sito.
  • La conservazione nell’indice è temporanea. Gli URL già indicizzati restano inizialmente nell’indice, ma la pipeline di indicizzazione di Google rimuove gli URL che restituiscono persistentemente un errore del server.
  • Il recupero è automatico e graduale. Quando il server torna a rispondere con 2xx, Google aumenta gradualmente la frequenza di scansione. Non servono reinvio, richiesta di riconsiderazione o rituali sul pulsante “validate fix” per il recupero ordinario: quel pulsante dice solo a Google di ricontrollare prima.

La conclusione più importante è questa: 502 viene trattato come 500 e 503. Non è “meno grave” perché nasce dal livello proxy/CDN invece che dall’applicazione d’origine. Non esiste una tolleranza documentata specifica per 502. Evidence for this claim Google handles 502 with its general 5xx behavior: reduced crawling, ignored response content, and eventual removal of persistently failing URLs. Scope: Google explicitly lists 502 among 5xx server errors; it does not guarantee that a particular short outage has no ranking effect. Confidence: high · Verified: Google: How HTTP status codes affect Google's crawlers

La durata è tutta la storia

Il fatto che un 502 ti danneggi davvero dipende da quanto dura, ma Google non pubblica una durata sicura fissa né una soglia fissa per la rimozione, quindi considera quanto segue un’indicazione pratica, non uno SLA:

  • Un picco breve (da pochi minuti a qualche ora) → la riduzione della frequenza di scansione di Google cresce con il numero di URL in errore, quindi un picco breve e circoscritto ha un impatto pratico ridotto e in genere non richiede indagini in Search Console. Nulla nella documentazione Google esenta formalmente gli errori brevi: è una questione di grado, non un limite rigido.
  • Un errore che continua a ripresentarsi o resta attivo → è la finestra in cui si applica la formulazione di Google “persistently return a server error” e le pagine possono iniziare a uscire dall’indice. Google non definisce “persistently” come un numero preciso di giorni. Il commento pubblico di Mueller (sotto) lo colloca informalmente nell’ordine di multiple days, con un recupero abbastanza rapido quando il sito è sano; è però la lettura di un professionista su un incidente specifico, non una regola documentata su cui fare affidamento per ogni sito o CDN.

Questo si collega in modo approssimativo all’interruzione di Cloudflare del novembre 2025, quando un’ondata di siti ha restituito errori 5xx senza colpa propria. La risposta pubblica di Mueller su Bluesky è stata che la scansione 5xx rallenta ma “ramps back up”: consulta la scheda Quotes per la formulazione esatta e le note sulla fonte, compreso un commento separato sui “diversi giorni” riportato da un riepilogo di terze parti e non verificato rispetto al thread originale. Un’interruzione breve e confermata dal provider è quasi il caso migliore: è visibile, in genere si risolve da sola e, una volta che il provider conferma il recupero e le tue risposte 2xx sono tornate, di solito conviene aspettare anziché modificare reattivamente l’infrastruttura.

Diagnosticare un 502 per livello

Poiché un 502 è un errore di comunicazione tra server, il modo più rapido per trovarlo è scendere nello stack — CDN, poi reverse proxy, poi origine — invece di eseguire una checklist piatta. (La scheda Decision Trees lo presenta come una procedura guidata.)

Un’avvertenza prima di iniziare: una pagina di errore personalizzata, il nome del provider in un header o l’aspetto dell’interruzione sono un segnale di prova, non la dimostrazione di quale hop abbia fallito. Correlali con gli header della risposta, gli ID della richiesta/trace e i log con timestamp su entrambi i lati dell’hop prima di concludere “è la CDN” o “è la mia origine”.

Livello CDN / edge

  • Timeout a monte: il nodo edge non ha ricevuto in tempo una risposta dall’origine.
  • L’edge non riesce a raggiungere affatto l’origine: errore di risoluzione DNS, errore di handshake SSL/TLS o firewall/sicurezza dell’origine che blocca gli intervalli IP della CDN.
  • Le cause documentate variano tra provider: la documentazione di troubleshooting di Cloudflare descrive scenari di connettività e timeout dell’origine specifici della sua rete edge, mentre AWS CloudFront documenta il proprio insieme di cause TLS, DNS, porta e funzione d’origine; controlla la documentazione della tua CDN senza presumere che l’elenco di un provider valga per un altro.
  • Interruzione del provider CDN (Cloudflare, Fastly, AWS ecc.): un evento di 502 di massa su siti non correlati che non ha nulla a che vedere con la salute del tuo server; verifica la pagina di stato del provider, non solo il branding della pagina di errore.

Livello reverse proxy / load balancer (Nginx, Apache mod_proxy, HAProxy)

  • Timeout del backend o connessione rifiutata.
  • Un proxy_pass / blocco upstream configurato male e diretto al posto sbagliato.
  • Esaurimento del pool backend: ogni worker upstream è occupato.
  • Mismatch SSL/TLS tra il proxy e il backend.

Livello server d’origine

  • Crash o riavvio dell’applicazione/PHP-FPM, oppure terminazione OOM (limite di memoria superato).
  • Esaurimento delle connessioni al database.
  • Un deploy/riavvio che causa una breve indisponibilità.
  • Un WAF o plugin di sicurezza che blocca IP legittimi del proxy o del crawler come se fossero aggressori: è il caso subdolo, perché i browser normali funzionano mentre il proxy (o Googlebot) riceve 502.

Vale la pena evidenziare quest’ultimo pattern: se solo Googlebot o solo le richieste passate dalla CDN ricevono 502 mentre i browser normali no, stai guardando un blocco specifico per bot o un problema di risposta variabile, non una vera interruzione. Prova direttamente verso l’origine e tramite CDN, poi verifica ciò che vede davvero Googlebot con il test live di URL Inspection in console di ricerca invece di presumere un impatto ancora in corso da un report Errore del server (5xx) che potrebbe essere già obsoleto.

Risolvere e prevenire i 502

Le correzioni dipendono dal livello e dal ruolo di chi deve applicarle:

  • Visitatore — non c’è nulla da correggere. Ricarica una volta, prova una rete diversa se sospetti un problema locale e altrimenti aspetta: le modifiche lato browser non possono riparare un errore tra server.
  • Proprietario del sito senza accesso all’infrastruttura — conferma l’ambito e controlla prima pagine di stato e log (vedi la checklist sotto), poi rivolgiti all’host, al supporto CDN o al team di sviluppo invece di tentare correzioni a caso.
  • Proprietario dell’host/CDN/applicazione — correggi la configurazione proxy/upstream, aumenta timeout e capacità backend quando l’origine è il collo di bottiglia reale e distribuisci i deploy in modo scaglionato per evitare che i riavvii interrompano l’intero pool. Tratta allowlist WAF, modifiche firewall e modifiche alla configurazione proxy/upstream come cambiamenti che richiedono approvazione: applicali solo quando log e prove del provider mostrano davvero un errore di firewall o controllo accessi, non come ipotesi iniziale; mettere in allowlist una CDN o un crawler non è una correzione generica per i 502.

Per prevenire il problema, vincono le attività noiose: monitoraggio uptime con alert, monitoraggio dei log di errore server e proxy, controllo dell’andamento Host status e Errore del server (5xx) nelle Crawl Stats di console di ricerca e correlazione dei picchi con le pagine di stato dei provider CDN e DNS, così distingui in pochi secondi “il mio problema” da “la loro interruzione”.

I codici correlati da tenere distinti sono proprio accanto in questo cluster: l’origine 500, il codice intenzionale 503 e il timeout 504.

Try it live

This is a real endpoint on this site — not a simulation. Hit it from the button, open it in a new tab, or curl -i it from your terminal, and the server answers with the actual status code this article is about.

Open in new tab ↗

Add an expert note

Pin an expert quote

New person? Create their unclaimed profile at /admin/experts/ → Pin a quote first.