Error 502 Bad Gateway: dove va ricercato il problema?

Di base il pro­to­col­lo di Internet HTTP fornisce codici di stato su richiesta. Il più frequente è pro­ba­bil­men­te il numero 200: esso sta per “OK” e significa che tutto ha fun­zio­na­to come doveva. Di solito questo stato non viene però mostrato agli utenti: i vi­si­ta­to­ri della pagina vedranno sem­pli­ce­men­te i contenuti richiesti. Non è invece lo stesso caso per le notifiche di errore: mentre il codice di errore 400 si trova sulle pagine del client, i codici dal 500 al 511 com­por­ta­no un errore lato server. I codici di stato danno in­di­ca­zio­ni di quale sia il punto in cui si è pre­sen­ta­to l’errore, o perlomeno a quegli utenti che sanno cosa si­gni­fi­ca­no i singoli codici.

L’errore 502 viene pre­sen­ta­to so­li­ta­men­te con l’aggiunta di “Bad Gateway” oppure appare come “502 Bad Gateway Nginx”, “502 Bad Gateway Apache”, o infine anche come “502 Bad Gateway re­gi­ste­red endpoint failed to handle the request”. Oltre al noto errore 404 (Pagina non trovata), gli errori di Bad Gateway fanno parte delle notifiche di errore più frequenti durante la na­vi­ga­zio­ne in Internet. Vengono vi­sua­liz­za­ti nel momento in cui il server, tramite il quale si attinge al server prin­ci­pa­le, non è riuscito a inoltrare la richiesta. In tal caso il primo server funge solamente da proxy, quindi da gateway, at­tra­ver­so i quali vengono inoltrate pra­ti­ca­men­te tutte le richieste su Internet. Per questo motivo questa notifica di errore risulta spesso così fru­stran­te: infatti non è ben chiaro in quale punto della serie di richieste si sia pre­sen­ta­to l’errore.

Nella maggior parte dei casi un errore di Bad Gateway viene a formarsi lato server e non può essere risolto dall’utente. È però al­tret­tan­to possibile che il browser uti­liz­za­to segnali un errore 502 anche se in realtà non sussiste. Inoltre esiste anche la pos­si­bi­li­tà che non via sia alcuna con­nes­sio­ne già a partire dal vostro network. Per cui la comparsa del codice HTTP può avere le seguenti cause:

• Down del web server: il gateway fra le altre cose riceve un esito negativo se il server di de­sti­na­zio­ne è down. Questo può succedere ad esempio per via di un crash del sistema. In casi molto rari i server vengono espulsi spon­ta­nea­men­te dalla rete, come quando i contenuti al loro interno hanno violato la legge.

• So­vrac­ca­ri­co del web server: se un web server arriva al limite delle sue capacità, le richieste non vengono più risolte e il gateway emette lo stato 502 Bad Gateway. I motivi dietro a ciò possono essere sia un interesse ina­spet­ta­to all’offerta ma anche un attacco DDoS: in questo caso gli hacker stanno tentando di so­vrac­ca­ri­ca­re le capacità del server con l’aiuto di una rete di bot per provocare così un down.

• Pro­gram­ma­zio­ne PHP difettosa: alle volte un errore può trovarsi all’interno del codice del sito web. Certe richieste non vengono più risolte ed emettono quindi un esito negativo.

• Errore di co­mu­ni­ca­zio­ne: tramite i firewall possono generarsi errori su entrambi i lati, sia server che client, durante l’inoltro delle richieste.

• Errore del browser: di tanto in tanto anche le esten­sio­ni dei browser possono provocare errori durante la rap­pre­sen­ta­zio­ne di siti web facendo sì che venga a co­sti­tuir­si un errore 502.

Sia i comuni utenti che gli esperti webmaster hanno la pos­si­bi­li­tà di reagire se si imbattono con un Bad Gateway. In molti casi può già bastare un attimo di attesa. Spesso l’errore si trova al di fuori del proprio raggio d’azione e viene risolto dal provider di Internet (ISP) o dal servizio di hosting senza che sia ne­ces­sa­rio un in­ter­ven­to. Se però l’errore si trova sulla vostra pagina dovete sapere dove cercare per trovarne la cause.

In al­ter­na­ti­va potete anche servirvi di un browser diverso dal vostro standard: se questo dovesse fun­zio­na­re allora è con­si­glia­bi­le in­stal­la­re da capo il vostro browser standard. Se però anche il cambio di browser non dovesse risolvere il problema dato dall’errore di Bad Gateway, allora è giunto il momento di prendere sotto esame le im­po­sta­zio­ni del vostro network. Il modo più semplice per farlo è di riavviare il modem e il router. Se nemmeno il riavvio non ha il successo de­si­de­ra­to provate a cambiare da WLAN a LAN e a uti­liz­za­re quindi una con­nes­sio­ne via cavo.

Ma alle volte l’errore non si trova in nessuna delle due parti, né da voi tantomeno dal gestore del sito web, bensì è il provider di Internet ad avere la colpa dell’in­sor­gen­za del 502 Bad Gateway. La causa è un in­se­ri­men­to sbagliato sul suo server DNS. Per eludere la notifica di errore inserite un altro server DNS nelle vostre im­po­sta­zio­ni. Su Windows è possibile mo­di­fi­car­lo nelle im­po­sta­zio­ni della vostra con­nes­sio­ne TCP/IP. Fate un test at­tin­gen­do ad esempio al server DNS libero di Google che potete rag­giun­ge­re digitando 8.8.8.8 e 8.8.4.4.

Se l’errore dovesse essere stato provocato dal webmaster non vi rimane molto altro da fare se non aspettare oppure uti­liz­za­re la versione della cache. Nella maggior parte dei casi l’errore è prov­vi­so­rio ed è già sot­to­po­sto a una ri­pa­ra­zio­ne da parte del webmaster. Proprio per quanto riguarda le pagine più ridotte può però risultare sensato prendere l’ini­zia­ti­va e con­tat­ta­re i gestori del sito web: può essere che non sappiano nulla del disturbo e sono felici di ricevere un sug­ge­ri­men­to.

Il vi­si­ta­to­re del vostro sito web vi comunica che riesce a vedere solamente la notifica di errore 502 quando prova ad aprire la vostra pagina. Cosa significa per voi? Come per gli utenti, anche per un webmaster non è facile iden­ti­fi­ca­re a prima vista dove possa trovarsi l’errore. Per prima cosa dovete ve­ri­fi­ca­re se il vostro sito web sia in generale rag­giun­gi­bi­le. Se il vostro server è ef­fet­ti­va­men­te down, allora dovete mettervi in contatto con il vostro servizio di hosting. Forse l’errore è già noto e il team di tecnici re­spon­sa­bi­le sta già lavorando per arrivare a una soluzione. Inoltre dovreste ricercare tra i file log del vostro server e vedere se rin­trac­cia­te notifiche di errore. Nello specifico la vostra pro­gram­ma­zio­ne in PHP può essere una fonte di errore. Ve­ri­fi­ca­te dunque se al suo interno o nel database vi siano delle possibili cause di errore. Per sicurezza dovreste uti­liz­za­re un vecchio back-up per risolvere in fretta il down. Di frequente l’errore sorge anche solamente perché il server era mo­men­ta­nea­men­te so­vrac­ca­ri­co oppure ci ha messo troppo tempo per fornire una risposta al server presente. Se so­vrac­ca­ri­chi di questo genere con­ti­nua­no a pre­sen­tar­si spesso, dovreste mettervi in contatto con il vostro servizio di hosting. Insieme potete trovare una migliore con­fi­gu­ra­zio­ne per il vostro web server che non perda colpi nemmeno nelle ore di punta del traffico di dati. In alcuni casi anche nella co­mu­ni­ca­zio­ne tra i diversi web server non tutto va liscio. Ac­cer­ta­te­vi quindi che il vostro firewall sia con­fi­gu­ra­to in maniera corretta e che non stia bloccando una richiesta legittima. Un’ulteriore fonte di errore può essere un mal­fun­zio­na­men­to della name re­so­lu­tion, ovvero l’as­se­gna­zio­ne dei nomi di dominio, perciò fate un controllo delle im­po­sta­zio­ni del na­me­ser­ver del vostro servizio di hosting. Su IONOS ad esempio avviene tramite il login cliente: qui se­le­zio­na­te il relativo dominio e cambiate le im­po­sta­zio­ni del DNS.