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: „A honlapon kritikus hiba történt.” 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ézze 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 tud lépni a vezérlőpultba, és ki tudja kapcsolni a hibás bővítményt. Nézze meg a spam mappát is.

2. Kapcsolja 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ítsa be:

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

Töltse be újra az oldalt, majd nyissa 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 kapcsolja 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 tegye 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. Kapcsolja ki a bővítményeket

A cPanel Fájlkezelőjében vagy FTP-n nevezze á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, nevezze vissza a mappát, majd a bővítményeket egyenként átnevezve keresse 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őrizze a sablont

Ha a bővítmények kikapcsolása nem segít, nevezze á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övelje 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ítsa vissza a mentést

Ha nem találja az okot, vagy sürgős a helyreállítás, állítsa 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, írjon ügyfélszolgálatunknak: a szerveroldali naplókból általában pontosan látszik az ok.