L’errore 520 è un codice specifico di Cloudflare che significa, in sostanza, “è successo qualcosa di strano”. Cloudflare è riuscito a collegarsi al server che ospita il sito, ma ha ricevuto una risposta vuota, incompleta o che non sa interpretare. Per questo il messaggio ufficiale parla di errore sconosciuto: Cloudflare sa che il problema è nel server di origine, ma non riesce a classificarlo in una delle categorie più precise che usa per gli altri errori.
In questa guida vediamo quando compare il 520, quali sono le cause più frequenti e un metodo per individuarle, visto che proprio la genericità del messaggio rende questo errore più difficile da diagnosticare degli altri.
Come nasce il 520
Quando un sito usa Cloudflare come proxy, ogni richiesta che non può essere servita dalla cache viene inoltrata al server di origine. Cloudflare apre la connessione, invia la richiesta e attende una risposta HTTP valida: una riga con il codice di stato, le intestazioni e il contenuto. Se la connessione si apre ma quello che torna indietro non è una risposta HTTP corretta, Cloudflare mostra il 520.
Il 520 si colloca quindi in una posizione precisa nella famiglia degli errori di Cloudflare. Con il 522 la connessione non si apre affatto; con il 524 si apre ma la risposta arriva troppo tardi; con il 502 la risposta arriva ma è di tipo non valido secondo le regole del proxy. Il 520 copre i casi residui: risposte vuote, connessioni chiuse a metà, intestazioni malformate o troppo grandi.
Come si presenta
La pagina di errore di Cloudflare mostra il titolo Web server is returning an unknown error con il codice Error code 520 e il solito schema con browser, Cloudflare e host, in cui l’host è segnato con errore. In fondo alla pagina c’è il Ray ID, l’identificativo univoco della richiesta, da annotare se pensi di dover contattare l’assistenza.
Un dettaglio utile per la diagnosi: il 520 compare spesso solo su alcune pagine o solo in alcune condizioni, per esempio quando sei collegato all’area riservata del sito, quando il carrello contiene molti prodotti o quando il server è sotto carico. Annota quando succede: è il primo indizio, e spesso basta da solo a restringere il campo a una o due cause possibili.
Le cause più comuni
Il server di origine si interrompe durante la risposta. Uno script che va in crash, un processo PHP terminato per aver superato i limiti di memoria, un servizio che si riavvia: in tutti questi casi la connessione si chiude senza che la risposta sia completa, e Cloudflare non ha nulla di valido da inoltrare al visitatore.
Risposta completamente vuota. Alcuni errori fatali producono una risposta senza alcun contenuto né intestazioni. Per un browser che si collega direttamente al server sarebbe una pagina bianca; per Cloudflare è un 520.
Intestazioni troppo grandi. Cloudflare impone limiti alla dimensione delle intestazioni di risposta. Un sito che invia molti cookie o cookie molto pesanti, come capita con alcuni plugin di tracciamento, di consenso o di commercio elettronico, può superare il limite: la risposta viene scartata e compare il 520. È la causa tipica dei 520 che colpiscono solo gli utenti collegati o con un carrello pieno, perché sono loro ad avere più cookie.
Firewall o regole di sicurezza che chiudono la connessione. Un firewall sul server di origine che, invece di bloccare in modo pulito, interrompe le connessioni provenienti da alcuni indirizzi di Cloudflare può generare risposte incomplete e quindi errori 520 intermittenti.
Configurazioni anomale del server. Risposte che non rispettano il protocollo, impostazioni di connessione persistenti incompatibili o software del server non aggiornati possono produrre risposte che Cloudflare non riesce a interpretare.
Come risolvere se sei un visitatore
Ricarica la pagina dopo qualche istante: molti 520 sono momentanei. Se l’errore compare solo quando sei collegato al tuo account o hai molti prodotti nel carrello, prova a cancellare i cookie del sito o ad aprirlo in una finestra in incognito, perché potresti essere tu ad avere un insieme di cookie troppo pesante. Se il problema persiste per tutti, il gestore del sito deve intervenire sul server.
Come risolvere se il sito è tuo
1. Verifica il server senza Cloudflare
Il primo passo è capire che cosa risponde davvero il server di origine. Puoi metterlo alla prova direttamente indicando il suo indirizzo IP con curl, come spiegato nella guida al 522, oppure modificando temporaneamente il file hosts del tuo computer. Se senza Cloudflare il server mostra un errore, una pagina bianca o una risposta incompleta, il problema è lì e va risolto lì.
2. Leggi i log del server di origine
Cerca nel log degli errori del server web e di PHP le righe con l’orario in cui è comparso il 520. Errori fatali di PHP, processi terminati, servizi riavviati o messaggi sulla dimensione delle intestazioni ti diranno quale delle cause viste sopra è quella giusta. Trovi come leggerli nella guida ai log del server.
3. Controlla dimensione di intestazioni e cookie
Apri gli strumenti per sviluppatori del browser e verifica le intestazioni di risposta di una pagina che dà errore, in particolare le righe Set-Cookie. Se vedi decine di cookie o valori lunghissimi, hai trovato un probabile colpevole. Identifica i plugin o gli script che li generano e riduci quelli superflui.
4. Autorizza gli indirizzi di Cloudflare
Come per il 522, assicurati che il firewall del server e i sistemi anti-attacchi non blocchino né limitino gli intervalli di indirizzi IP pubblicati da Cloudflare. Un blocco parziale produce errori intermittenti difficili da diagnosticare.
5. Escludi plugin e applicazione
Se il 520 riguarda solo alcune pagine, la causa è probabilmente nel codice che quelle pagine eseguono. Su WordPress il metodo è sempre lo stesso: disattivare i plugin e riattivarli uno alla volta, poi passare a un tema predefinito. Lo trovi descritto passo per passo nella guida agli errori di WordPress.
6. Contatta l’assistenza con i dati giusti
Se non trovi la causa, contatta l’hosting e, se necessario, il supporto di Cloudflare, indicando gli indirizzi coinvolti, gli orari, i Ray ID delle pagine di errore e le righe dei log che hai raccolto. Con queste informazioni la diagnosi diventa molto più rapida.
Perché il 520 compare a intermittenza
Uno degli aspetti più frustranti del 520 è che va e viene. I motivi sono quasi sempre tre. Il server è al limite delle risorse e alcuni processi vengono terminati solo nei momenti di picco. Le intestazioni superano il limite solo per alcuni utenti, quelli con più cookie. Il firewall blocca solo alcuni degli indirizzi di Cloudflare, e il problema si presenta solo quando la richiesta passa da uno di quelli. Incrociare gli orari degli errori con i grafici del server e con le condizioni dell’utente, collegato o no, carrello pieno o vuoto, porta quasi sempre alla causa.
Come prevenire il 520
Molti 520 si possono evitare con qualche accorgimento. Tieni sotto controllo il numero di plugin e script che impostano cookie: ogni strumento di tracciamento, chat o personalizzazione aggiunge peso a ogni risposta del server, e i problemi emergono solo quando la somma supera il limite. Mantieni aggiornati PHP, il server web e l’applicazione, perché molte risposte malformate nascono da combinazioni di versioni non compatibili. Assicurati che il server abbia risorse sufficienti per i picchi di traffico, così che i processi non vengano terminati a metà del lavoro. Infine, dopo ogni modifica importante, come un nuovo plugin di commercio elettronico o un cambio di configurazione del server, controlla le pagine più delicate del sito, in particolare quelle dell’area utenti e del carrello, sia da utente anonimo sia da utente collegato.
Errore 520 e SEO
Per Google un 520 equivale a un errore del server. Se è raro, non ha conseguenze; se colpisce molte pagine o dura a lungo, riduce la frequenza di scansione e può portare alla rimozione temporanea delle pagine dai risultati. I 520 che colpiscono solo gli utenti collegati, in genere, non toccano Googlebot, che naviga senza cookie; quelli che dipendono dal server, invece, sì. Per questo conviene monitorare il sito con un servizio esterno e controllare il rapporto sull’indicizzazione di Search Console dopo ogni periodo di instabilità.
Domande frequenti
Il 520 è un problema di Cloudflare?
Quasi mai. Cloudflare segnala che il server di origine ha restituito una risposta che non riesce a interpretare. La causa va cercata sul server dell’hosting o nell’applicazione.
Perché il 520 compare solo quando sono collegato al sito?
Probabilmente perché da utente collegato ricevi più cookie, e le intestazioni della risposta superano il limite di Cloudflare. Ridurre il numero e la dimensione dei cookie di solito risolve.
Il 520 può dipendere dal certificato SSL?
In genere no: i problemi di certificato tra Cloudflare e il server di origine producono codici specifici, come il 525 o il 526. Se vedi un 520, concentrati su risposte vuote, crash dell’applicazione, intestazioni troppo grandi e regole del firewall.
Mettere Cloudflare in pausa risolve il 520?
Fa sparire il codice 520, ma non la causa: senza Cloudflare i visitatori vedrebbero l’errore originale del server. È utile come test, non come soluzione.
