Külastate oma saiti ja näete valget ekraani kolme sõnaga: „502 Bad Gateway". Liiklus käib, kuid külastajad näevad sisu asemel tõrget. Müük peatub, SEO-reitingud langevad ja te raiskate aega oletamisele.

502 viga tundub hirmutav, kuid tegelikult on see lihtsalt serveritevaheline suhtlustõrge. Teie sait ei ole katki, andmed pole kadunud ja enamikul juhtudel võtab parandamine aega viis kuni viisteist minutit. Allpool on samm-sammuline juhend, mis viib teid kõige lihtsamatest kontrollidest sügavama diagnostikani.

💡 Kiire ülevaade:

• Värskendage lehte ja kontrollige, kas hostimisserver on maas
• Tühjendage brauseri vahemälu ja keelake ajutiselt CDN
• Kui viga püsib, keelake pluginad FTP kaudu ja kontrollige teemat
• Lähtestage .htaccess ja võtke ühendust oma hostiteenuse pakkujaga, kui miski muu ei aita

Mis on 502 Bad Gateway viga

Kui avate saidi, saadab brauser HTTP-päringu. Serveri poolel võtab selle vastu pöördproksi (Nginx, Apache) ja jaotab päringud rakendusserveri (PHP), andmebaasi, staatilise veebiserveri ja CDN-i vahel. Iga sõlm töötleb oma osa ja tagastab tulemuse proksiserverile. Proksi koostab vastuse ja toimetab selle brauserisse ning leht laeb.

502 viga ilmneb siis, kui üks selle ahela serveritest tagastab proksiserverile vigase vastuse. Proksi ei suuda lehte kokku panna ja kuvab „Bad Gateway". Brauser teatab ausalt, et serveritevaheline lüüs sai midagi ootamatut.

Väliselt võib viga esineda erineval kujul: „502 Bad Gateway", „502 Service Temporarily Overloaded", „HTTP 502", „Nginx 502 Bad Gateway", „Proxy Error". Sisuliselt on see sama: kusagil ahelas on katkestus.

Miks 502 viga tekib

Põhjused on peaaegu alati serveripoolsed, kuid mõnikord käivitavad selle teie enda tegevused saidil:

• Serveri ülekoormus. Järsk liikluse kasv ammendab hostingu ressursid ja PHP-protsessid ei jõua päringujärjekorraga sammu pidada.
• Vigane plugin või teema. Kood, mis põhjustab fataalse PHP vea, lõpetab rakendusserveri vastuse ja proksi ei saa midagi.
• CDN-i probleemid. Cloudflare, KeyCDN või mõni muu sisu edastamise teenus ei suuda lähteserveriga ühendust luua ja tagastab 502.
• Valed DNS-kirjed. Pärast hostiteenuse pakkuja vahetamist või DNS-serverite uuendamist ei ole kirjed veel levida jõudnud, mistõttu sait on ajutiselt kättesaamatu.
• Rikutud.htaccess. Katkine süntaks või vastuolulised ümberkirjutamise reeglid lõhuvad päringute käsitlemise.
• PHP mälulimiit ammendatud. Raske plugin või skript tarbib kogu saadaoleva mälu ja protsess jookseb kokku.

Nüüd käime iga paranduse samm-sammult läbi, alates kiireimast kuni keerulisemani.

1. Samm. Värskendage lehte

Esimene ja lihtsaim: vajutage F5 või Ctrl+R. Kui vea põhjustas lühiajaline serveri tõrge, siis korduv päring õnnestub. Proovige saiti avada teises brauseris või mobiilse andmeside kaudu; see välistab probleemi teie poolel.

Kontrollige, kas sait töötab ülejäänud maailma jaoks, kasutades isup.me või Down For Everyone Or Just Me. Kui teenus näitab, et sait on maas ainult teie jaoks, on probleem lokaalne, seega liikuge edasi. Kui sait pole kõigile kättesaadav, on hostimisserver suure tõenäosusega kokku jooksnud või on rakendatud blokeering teenusepakkuja tasemel.

2. Samm. Tühjendage brauseri vahemälu

Brauser salvestab vahemällu mitte ainult pilte ja stiile, vaid ka vigaseid serverivastuseid. Kõva värskendus (Windowsis Ctrl+F5, macOS-is Cmd+Shift+R) sunnib brauserit lehte uuesti küsima, minnes mööda kohalikust vahemälust.

Kui kõva värskendus ei aidanud, tühjendage vahemälu täielikult. Chrome'is: Seaded → Privaatsus ja turvalisus → Sirvimisandmete kustutamine → „Vahemällu salvestatud pildid ja failid". Üksikasjalikud juhised erinevate brauserite ja WordPressi poole vahemälu tühjendamiseks leiate eraldi juhendist.

3. Samm. Keelake ajutiselt CDN

Sisu edastamise võrgud, nagu Cloudflare või KeyCDN, suunavad liikluse läbi oma serverite. Kui CDN-i poolel ilmneb tõrge või on seadistatud vale tulemüüri reegel, näevad külastajad 502 isegi siis, kui lähteserver on täiesti töökorras.

Selle hüpoteesi kontrollimiseks peatage CDN selle juhtpaneelil. Cloudflare: minge Ülevaade → Peata Cloudflare. KeyCDN ja sarnased teenused: leidke paneelilt nupp Keela või Peata. Pärast keelamist värskendage oma saiti. Kui viga kaob, on probleem CDN-i poolel; võtke ühendust nende toega.

Kui CDN on keelatud, töötab sait otse teie hostingust, nii et kiirus võib veidi langeda, kuid kättesaadavus taastub. Võrdlesime populaarseid CDN-teenuseid ja nende seadistamist artiklis tasuta CDN-idest WordPressile.

4. Samm. Kontrollige DNS-i seadeid

Pärast hostiteenuse pakkuja vahetamist või NS-kirjete uuendamist levib DNS-i teave üle võrgu ajavahemikus mõnest tunnist kuni 48 tunnini. Selle aja jooksul võivad mõned külastajad sattuda vanale serverile, mis ei vasta või vastab valesti.

Kui kolisite hiljuti oma saiti, oodake 24 tundi; see on tavaliselt piisav. Lisaks tühjendage oma kohalik DNS-i vahemälu: Windowsis avage käsuviip ja käivitage ipconfig /flushdns; macOS-is käivitage sudo dscacheutil -flushcache ja sudo killall -HUP mDNSResponder. Seejärel värskendage lehte.

5. Samm. Keelake pluginad FTP kaudu

Kõige levinum 502 vea põhjus WordPressis on pluginakonflikt. Üksainus probleemne plugin võib põhjustada fataalse PHP vea, mis viib kogu saidi alla. Kuna WordPressi administraatoripaneel pole 502 vea ajal ligipääsetav, peate pluginad keelama failisüsteemi kaudu.

Looge serveriga ühendus FTP kaudu (kasutades FileZillat, WinSCP-d) või avage failihaldur cPanelis. Liikuge saidi juurkausta (tavaliselt public_html):

Minge kausta wp-content ja leidke kaust plugins. Nimetage see ümber, näiteks plugins.old. See keelab koheselt kõik pluginad korraga. Pluginate andmeid kausta ümbernimetamisel ei kustutata; seaded jäävad andmebaasi:

Värskendage saiti. Kui see töötab, on probleem ühes pluginas. Nimetage kaust tagasi plugins, minge administraatoripaneelile ja lubage pluginad ükshaaval, kontrollides saiti pärast iga aktiveerimist. Kui olete süüdlase leidnud, kustutage see FTP kaudu või asendage alternatiiviga.

6. Samm. Kontrollige aktiivset teemat

Kui pluginade keelamine ei aidanud, on järgmine kahtlusalune teema. Vigane kood failis functions.php või konflikt PHP versiooniga võib samamoodi põhjustada fataalse vea ja 502.

Minge tagasi saidi juurkausta → wp-content → themes. Leidke aktiivse teema kaust ja nimetage see ümber (näiteks lisage lõppu .old):

WordPress lülitub automaatselt vaiketeemale (Twenty Twenty-Four, Twenty Twenty-Five või sarnane). Värskendage saiti; kui viga on kadunud, on probleem teemas. Võtke ühendust teema arendajaga või taastage varukoopia. Pärast diagnoosimist nimetage kaust tagasi oma algse nimega.

Üksikasjalik algoritm teemade kontrollimiseks ja vastuolulise koodi leidmiseks on kirjeldatud WordPressi teemaprobleemide tõrkeotsingu juhendis.

7. Samm. Lähtestage.htaccess fail

Rikutud .htaccess on sage, kuid vähem ilmne 502 vea põhjus. Vahemälu plugina või turvaplugina lisatud ümberkirjutamise reeglid võivad omavahel vastuollu minna. Üksainus süntaksiviga selles failis ja server tagastab 502 kõigile päringutele.

Looge ühendus FTP kaudu ja leidke saidi juurkaustast fail .htaccess. Laadige varukoopia alla oma arvutisse, seejärel kustutage fail serverist. Minge WordPressi administraatoripaneelile, navigeerige Seaded → Püsilingid ja klõpsake „Salvesta muudatused" (midagi muutmata). WordPress loob uue .htaccess faili puhta reeglistikuga.

Kui viga ilmnes kohe pärast vahemälu plugina (WP Rocket, W3 Total Cache, LiteSpeed Cache) paigaldamist, kontrollige .htaccess failis selle plugina reeglite sektsiooni; see on tavaliselt ümbritsetud kommentaaridega nagu # BEGIN W3TC / # END W3TC. Kustutage see plokk, salvestage fail ja värskendage saiti.

8. Samm. Võtke ühendust oma hostiteenuse pakkujaga

Kui ükski eelmistest sammudest ei aidanud, on probleem suure tõenäosusega serveri poolel. Võtke ühendust oma hostiteenuse pakkuja tehnilise toega ja esitage domeen, vea ilmnemise aeg ja milliseid samme olete juba astunud. Mida rohkem üksikasju annate, seda kiiremini leiavad insenerid põhjuse.

Paluge neil kontrollida PHP ja veebiserveri vealogisid perioodi kohta, mil 502 ilmnes. Logid näitavad peaaegu alati täpselt, milline skript või moodul tõrget põhjustab. Odavatel jagatud hostingu pakettidel võib põhjuseks olla lihtsalt ressursside puudus: üks sait serveris tarbib kogu mälu ja ülejäänud saavad 502. Sel juhul on mõttekas kaaluda kolimist VPS-i või pilvehostingule, kus on garanteeritud ressursid.

Videojuhend

Vaadake visuaalset läbikäiku 502 vea diagnoosimisest ja parandamisest esimesest sammust viimaseni selles videos:

⁉️🤔 Korduma kippuvad küsimused

Kas 502 viga võib iseenesest laheneda?

Jah, kui põhjuseks on hostimisserveri lühiajaline ülekoormus. Teenusepakkujad jälgivad koormust ja taaskäivitavad probleemsed protsessid automaatselt ühe kuni viie minuti jooksul. Värskendage lehte paari minuti pärast; pooltel juhtudel kaob viga ilma teiepoolse sekkumiseta.

Kuidas eristada 502 teistest serverivigadest?

502 Bad Gateway on viga proksiserveri tasemel (Nginx/Apache), mitte rakenduses endas. 500 Internal Server Error viitab probleemile otse PHP koodis või konfiguratsioonis. 503 Service Unavailable tähendab, et server ei võta ajutiselt päringuid vastu, tavaliselt plaanilise hoolduse ajal. 504 Gateway Timeout tähendab, et server ei saanud ülesvoolu serverilt vastust ettenähtud aja jooksul. Kasutaja jaoks taandub erinevus diagnostikale: 500 parandatakse enamasti koodi redigeerides, 502 aga serveritevahelise suhtluse taastamisega.

Kas 502 vea korral pean saidi varukoopiast taastama?

Varukoopia on viimane abinõu, mitte esimene samm. Enne varukoopia rakendamist järgige selle juhendi samme 5, 6 ja 7: keelake pluginad, kontrollige teemat, lähtestage .htaccess. Valdav enamik 502 juhtumeid laheneb ilma varukoopiat taastamata. Rakendage varukoopia ainult siis, kui viga ilmnes kohe pärast WordPressi, pluginade või teema uuendamist ja muudatuste tagasipööramine FTP kaudu pole võimalik.

Kas ma saan tulevikus 502 vigu ennetada?

Osaliselt jah. Kasutage kvaliteetset hostimist piisava PHP mäluga (soovitatav miinimum on 256 MB). Seadistage oma saidile tööaja monitooring UptimeRoboti või sarnase teenuse kaudu; saate probleemist teada enne, kui külastajad sellest teatavad. Enne pluginade paigaldamist või uuendamist tehke kiire varukoopia. Ja hoidke FTP ligipääs käepärast: kui administraatoripaneel on maas, on see ainus viis probleemse koodi kiireks keelamiseks.

Mida teha, kui miski ei aidanud?

Ülaltoodud kaheksa sammu katavad peaaegu kõik 502 Bad Gateway stsenaariumid WordPressis. Kui olete kontrollinud pluginaid, teemat, DNS-i ja CDN-i, lähtestanud .htaccess faili ja viga püsib, on probleem sügavam ja te ei saa hakkama ilma hostinguteenuse insenerideta.

Õige järjekord säästab tunde: esmalt välistage lokaalsed põhjused (vahemälu, brauser, CDN), seejärel serveripoolsed põhjused (pluginad, teema, .htaccess) ja alles seejärel eskaleerige teenusepakkujale. Salvestage see juhend oma järjehoidjatesse; 502-l on komme naasta kõige ebasobivamal hetkel ja kiire ligipääs sellele kontrollnimekirjale säästab teid paljust stressist.