WordPress fehér halál képernyő (White Screen of Death): mi a teendő?

WordPress 2 perc olvasás

A „fehér halál képernyő” (White Screen of Death, röviden WSOD) az egyik legijesztőbb WordPress hiba: az oldal betöltésekor nem jelenik meg semmi, csak egy üres, fehér lap. Újabb WordPress verziók ehelyett gyakran ezt az üzenetet írják ki: „Súlyos hiba történt a webhelyünkön.” A jó hír, hogy a probléma szinte mindig visszafordítható, és a tartalom nem vész el.

Mi okozhatja?

A leggyakoribb okok:

  • egy hibás vagy a WordPress, illetve a PHP verziójával nem kompatibilis bővítmény,
  • egy hibás vagy elavult sablon,
  • a PHP memóriakorlát túllépése,
  • egy félbeszakadt frissítés,
  • PHP-verzióváltás után egy régi bővítmény, amely az új verzión már nem fut.

Ha a hiba egy frissítés vagy bővítménytelepítés után jelent meg, nagy valószínűséggel az okozza.

1. Nézd meg a helyreállítási e-mailt

A WordPress 5.2 óta a kritikus hibákról e-mailt küld a webhely adminisztrátori címére. A levélben szerepel, melyik bővítmény vagy sablon okozta a hibát, és egy helyreállítási link, amellyel be tudsz lépni a vezérlőpultba, és ki tudod kapcsolni a hibás bővítményt. Nézd meg a spam mappát is.

2. Kapcsold be a hibanaplózást

A tényleges hibaüzenetet a WordPress hibanaplója mutatja meg. A wp-config.php fájlban, a /* That's all, stop editing! */ sor előtt állítsd be:

define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);
define('WP_DEBUG_DISPLAY', false);

Töltsd be újra az oldalt, majd nyisd meg a wp-content/debug.log fájlt: az utolsó sorok megmutatják a hibás fájl útvonalát (például wp-content/plugins/bovitmeny-neve/...). A hibakeresés végén kapcsold ki a naplózást (WP_DEBUG értéke false), mert a napló idővel nagyra nőhet. A beállításról részletesebben a WP_DEBUG-ról szóló cikkünk ír; azt, hogyan tedd a naplót a webről nem elérhető helyre, a hibakeresési módról szóló tudásbázis-cikk mutatja meg. cPanel tárhelyen a súlyos PHP-hibák hibakeresési mód nélkül is a home könyvtár logs/php.error.log fájljába kerülnek.

3. Kapcsold ki a bővítményeket

A cPanel Fájlkezelőjében vagy FTP-n nevezd át a wp-content/plugins mappát (például plugins-old-ra). Ez az összes bővítményt kikapcsolja. Ha az oldal ettől helyreáll, nevezd vissza a mappát, majd a bővítményeket egyenként átnevezve keresd meg a hibásat. WP-CLI-vel egyszerűbb: wp plugin deactivate --all, majd egyenként wp plugin activate bovitmeny-neve. Ha egy frissítés után egyetlen bővítmény a gyanúsított, a bővítményfrissítés utáni 500-as hibáról szóló cikk a célzott kikapcsolást írja le.

4. Ellenőrizd a sablont

Ha a bővítmények kikapcsolása nem segít, nevezd át a használt sablon mappáját a wp-content/themes alatt. A WordPress ilyenkor egy alapértelmezett sablonra (például Twenty Twenty-Five) vált, ha az telepítve van.

5. Növeld a PHP memóriakorlátot

A „Allowed memory size exhausted” hibaüzenet a memóriakorlát túllépését jelzi. A memory_limit értéke a .user.ini fájlban növelhető, erről a .user.ini fájl használatáról szóló cikk ír; cPanel tárhelyen a Select PHP Version felületén is beállítható.

6. Állítsd vissza a mentést

Ha nem találod az okot, vagy sürgős a helyreállítás, állítsd vissza a hiba előtti állapotot a napi mentésből; a lépéseket a WordPress mentésének visszaállításáról szóló cikk mutatja be.

Ha ezek után is fennáll a probléma, írj ügyfélszolgálatunknak: a szerveroldali naplókból általában pontosan látszik az ok.

Vissza: WordPress leírások (45)