WordPress baltas ekranas beveik visada reiškia PHP klaidą, kurią serveris nuslėpė: naršyklė gauna tuščią puslapį, nes kodo vykdymas nutrūko dar nesugeneravus HTML. Per pirmas dešimt minučių reikia padaryti keturis dalykus — įsitikinti, kad yra atsarginė kopija, įjungti klaidų žurnalą (WP_DEBUG), padidinti PHP atminties limitą ir per FTP išjungti papildinius. Daugumai atvejų tuo viskas ir baigiasi. Esu Tomas, front-end programuotojas iš Vilniaus; per aštuonerius su puse metų ir 97+ projektų baltą ekraną teko gesinti ne vieną kartą, todėl žemiau surašiau tikslią eilės tvarką, be spėliojimų.
Kodėl atsiranda WordPress baltas ekranas
Angliškai tai vadinama „White Screen of Death“. Techninė priežastis visada ta pati: PHP procesas sustojo su neatstatoma klaida, o serveryje išjungtas klaidų rodymas, todėl vietoje pranešimo gaunate tuščią langą. Tikrųjų kaltininkų, kurie tą sustojimą sukelia, yra keli:
- Papildinio ar temos kodo klaida. Dažniausias atvejis ir beveik visada po atnaujinimo arba po kodo redagavimo administravimo srityje.
- Išnaudotas atminties limitas. „Allowed memory size exhausted“ — didesnėse parduotuvėse ir svetainėse su daug papildinių tai eilinis reiškinys.
- PHP versijos nesuderinamumas. Hostingas perkėlė svetainę į PHP 8.x, o senas papildinys naudoja sintaksę, kurios nebėra.
- Sugadintas branduolio failas arba .htaccess. Nepilnai persiuntus failus arba nutrūkus atnaujinimui.
- Serverio limitai. Pasiektas vykdymo laiko limitas ar procesų riba bendrame hostinge.
- Įsilaužimas. Į failus įrašytas kenkėjiškas kodas su klaida — tada baltas ekranas yra tik simptomas.
Pirmas naudingas skirstymas — kurios svetainės dalys neveikia. Tai iš karto sumažina paieškos sritį per pusę:
| Simptomas | Tikėtina priežastis | Pirmas žingsnis |
|---|---|---|
| Baltas ir viešas puslapis, ir /wp-admin/ | Papildinys, atminties limitas arba branduolio failas | Įjungti WP_DEBUG_LOG, išjungti papildinius per FTP |
| Viešas puslapis baltas, administravimas veikia | Tema arba temos functions.php | Pervardyti aktyvios temos katalogą |
| Veikia tik pradinis puslapis, kiti balti | Nuolatinių nuorodų struktūra, .htaccess | Pervardyti .htaccess ir iš naujo išsaugoti nuorodų nustatymus |
| Baltas ekranas atsirado po atnaujinimo | Temos ir papildinio arba PHP versijos konfliktas | Grąžinti atnaujintą komponentą į ankstesnę versiją |
| Baltas tik vienas puslapis ar produktas | Konkretaus bloko, trumpojo kodo ar užklausos klaida | Žiūrėti debug.log įrašą tuo laiku |
Pirmos 10 minučių: ką daryti iš eilės
1. Nieko netrinkite ir neatnaujinkite
Dažniausia priežastis, kodėl pusvalandžio darbas tampa kelių dienų atkūrimu, yra chaotiški bandymai gelbėti. Pirmas veiksmas — pasitikslinti, kad atsarginė kopija egzistuoja: hostingo skydelyje, papildinyje arba savame diske. Jei kopijos nėra, pirma nusikopijuokite failus ir duomenų bazę tokius, kokie yra dabar — net sugedusi būklė yra geriau nei nieko.
2. Patikrinkite, ar tai ne jūsų naršyklė
Atidarykite svetainę inkognito režimu ir iš telefono mobiliuoju internetu. Pasitaiko, kad „svetainė neveikia“ tik viename kompiuteryje dėl kešo ar DNS. Tuo pačiu naršyklės įrankiuose (skirtukas „Network“) pažiūrėkite atsako kodą: 200 su tuščiu turiniu rodo PHP klaidą, 500 — serverio klaidą, 403 ar 503 — dažniau hostingo apribojimą ar blokavimą.
3. Įjunkite klaidų žurnalą
Tai svarbiausias žingsnis, nes nuo jo prasideda tikras atsakymas, o ne spėjimai. Failo wp-config.php viršuje, prieš eilutę su /* That's all, stop editing! */, įrašykite:
define( 'WP_DEBUG', true );define( 'WP_DEBUG_LOG', true );define( 'WP_DEBUG_DISPLAY', false );
Trečioji eilutė reikalinga tam, kad klaidos nebūtų rodomos lankytojams — jos keliaus į failą wp-content/debug.log. Perkraukite puslapį ir atidarykite tą failą: paskutinė „Fatal error“ eilutė nurodys tiksliai failą ir eilutę, dažniausiai kartu su papildinio katalogo pavadinimu. Jei debug.log nesusikuria, ieškokite serverio error_log failo svetainės šaknyje arba hostingo žurnalų skiltyje. Baigę darbus WP_DEBUG būtinai išjunkite.
4. Padidinkite PHP atminties limitą
Jei žurnale matote „Allowed memory size of … bytes exhausted“, priežastis rasta. Į wp-config.php įrašykite define( 'WP_MEMORY_LIMIT', '256M' );, o jei to neužtenka — hostingo skydelyje arba .user.ini faile padidinkite memory_limit iki 256 MB. Reprezentacinei svetainei paprastai pakanka 128 MB, WooCommerce parduotuvei realiai reikia 256 MB. Svarbu suprasti, kad limito didinimas yra pirmoji pagalba: jei atmintį suvalgo konkretus papildinys, po mėnesio neužteks ir 512 MB.
5. Išjunkite papildinius per FTP
Kai į administravimą patekti negalima, papildiniai išjungiami failų lygmeniu. Prisijunkite per FTP arba hostingo failų tvarkyklę ir pervardykite katalogą wp-content/plugins į plugins-off. WordPress nebeaptiks nė vieno papildinio ir juos išjungs — nustatymai niekur nedings, nes jie laikomi duomenų bazėje. Jei svetainė atsidarė, pervardykite katalogą atgal ir papildinius įjunkite po vieną, kiekvieną kartą perkraudami puslapį. Tas, su kuriuo ekranas vėl pabąla, ir yra kaltininkas. Jei nežinote, kuo WordPress įskiepiai skiriasi nuo temos funkcijų, pradėkite nuo jų: praktikoje kaltas būna papildinys.
6. Pakeiskite temą ir patikrinkite .htaccess
Jei papildiniai nekalti, pervardykite aktyvios temos katalogą faile wp-content/themes. WordPress automatiškai persijungs į numatytąją temą, jei ji įdiegta. Papildomai pervardykite .htaccess į .htaccess-old ir perkraukite puslapį — jei pradeda veikti, užteks administravimo srityje iš naujo išsaugoti nuolatinių nuorodų nustatymus, kad failas būtų sukurtas naujas.
Baltas ekranas ar WordPress klaida 500 — ar skirtumas svarbus
Praktiškai taip, nes nulemia, kurį žurnalą atverti pirmą. WordPress klaida 500 reiškia, kad serveris pats sustojo ir prisipažino: dažniausios priežastys — sugadintas .htaccess, netinkama PHP direktyva, viršyti serverio limitai arba PHP procesų trūkumas. Informacijos tada ieškoma serverio error_log faile. Baltas ekranas su kodu 200 reiškia, kad PHP nutrūko „tyliai“, ir tikroji klaida bus WordPress debug.log faile. Jei vietoje balto ekrano matote hostingo pranešimą apie duomenų bazės ryšį, problema trečia — neteisingi prieigos duomenys wp-config.php faile arba perkrautas duomenų bazės serveris.
Kada verta nustoti taisyti patiems
Savarankiškas taisymas turi aiškią ribą. Kviesti pagalbą verta, kai:
- Nėra atsarginės kopijos. Tada kiekvienas eksperimentas yra statymas be tinklo.
- Tai e-parduotuvė darbo metu. Prastova kainuoja greičiau, nei pavyks išmokti FTP.
- Debug.log rodo branduolio failą, ne papildinį. Dažnai reiškia nepilną atnaujinimą arba pakeistus failus.
- Yra įsilaužimo požymių — svetimi administratoriai, nukreipimai į nežinomus puslapius, hostingo pranešimas apie kenkėjišką kodą. Valymas be spragos radimo problemos nesprendžia.
- Problema grįžta. Pataisėte, po dienos vėl balta — vadinasi, rasta ne priežastis, o simptomas.
Kol laukiate, geriausia nieko nedaryti. Tai nuobodus patarimas, bet dalis sudėtingų atvejų, kuriuos esu tvarkęs, buvo sudėtingi ne dėl pirminės klaidos, o dėl to, kas buvo padaryta po jos.
Ką padaryti, kad baltas ekranas nepasikartotų
Prevencija čia nuobodi ir veikia. Pirma, atsarginės kopijos ne tame pačiame serveryje ir bent kartą patikrintos atkūrimu. Antra, atnaujinimai po vieną, ne visi iš karto, ir ne penktadienio vakarą. Trečia, testinė kopija svarbesnėms svetainėms — ten atnaujinama pirmiau. Ketvirta, suderinta PHP versija: prieš hostingo perjungimą patikrinama papildinių suderinamumas. Visa tai sudėta į WordPress priežiūros kontrolinį sąrašą, o jei norite, kad tuo kas mėnesį pasirūpintų kas nors kitas — tam yra priežiūros planai. Atskirai verta pažiūrėti ir į hostingo pasirinkimą: dalis balto ekrano atvejų yra tiesiog per ankšti pigaus plano limitai, o tą pačią problemą normaliame serveryje svetainė atlaiko be klaidos.
Kaip galiu padėti
Jei svetainė neveikia dabar, o laiko gilintis nėra — tam yra skubi techninė pagalba. Atsakau per keturias darbo valandas, pirminė diagnostika nemokama: pirma pasakau, kas nutiko ir kiek kainuos sutvarkyti, ir tik po jūsų patvirtinimo pradedu darbus. Skubūs darbai — 50 €/val., dažniausios balto ekrano priežastys išsprendžiamos per vieną–dvi valandas. Jei problema neskubi ir galima suderinti laiką, taikomas įprastas 30 €/val. įkainis. Prieš bet kokius taisymus visada padarau atsarginę kopiją, o pabaigoje paaiškinu, kas nutiko ir ką pakeisti, kad nepasikartotų.
Dažniausiai užduodami klausimai
Kodėl WordPress rodo baltą ekraną be jokio klaidos teksto?
Nes serveryje išjungtas PHP klaidų rodymas. Procesas nutrūksta dėl kodo klaidos arba išnaudoto atminties limito, bet vietoje pranešimo naršyklė gauna tuščią atsaką. Įjungus WP_DEBUG su WP_DEBUG_LOG, tikroji klaida atsiranda faile wp-content/debug.log — su failo pavadinimu ir eilutės numeriu.
Kaip išjungti papildinius, jei negaliu patekti į administravimą?
Per FTP arba hostingo failų tvarkyklę pervardykite katalogą wp-content/plugins į plugins-off. WordPress visų papildinių neberas ir juos išjungs. Jei svetainė atsidaro, pervardykite katalogą atgal ir papildinius įjunkite po vieną — kuris nulaužia puslapį, tas ir kaltas.
Ar pervardijus papildinių katalogą prarasiu nustatymus?
Ne. Papildinių nustatymai saugomi duomenų bazėje, ne failuose. Pervardijus katalogą papildiniai tik išjungiami; grąžinus pavadinimą ir įjungus juos iš naujo, nustatymai būna vietoje. Rizika atsiranda tik tada, jei papildinius ištrinate, o ne išjungiate.
Kuo skiriasi baltas ekranas ir WordPress klaida 500?
Baltas ekranas dažniausiai grąžinamas su atsako kodu 200 — serveriui atrodo, kad viskas gerai, tik turinio nėra. Klaida 500 reiškia, kad serveris pats pripažino vidinę klaidą; tada daugiau informacijos būna serverio error_log faile. Priežastys dažnai tos pačios, bet pirmiausia žiūrimi skirtingi žurnalai.
Kiek laiko užtrunka sutvarkyti baltą ekraną?
Jei priežastis yra papildinio konfliktas arba atminties limitas, dažniausiai pakanka vienos–dviejų valandų nuo prieigos duomenų gavimo. Ilgiau užtrunka tada, kai sugadinti branduolio failai, nėra atsarginės kopijos arba svetainė buvo nulaužta — čia reikia ne tik grąžinti veikimą, bet ir rasti spragą.
Ar galima tiesiog grąžinti svetainę iš atsarginės kopijos?
Galima ir dažnai tai greičiausias kelias, bet su dviem išlygomis. Pirma, kopija turi būti senesnė už problemą, o e-parduotuvėje tarp jos ir šiandienos gali būti užsakymų, kuriuos prarasite. Antra, jei neištaisyta priežastis — pavyzdžiui, nesuderinta PHP versija — baltas ekranas grįš po pirmo atnaujinimo.