Ha WordPress-alapú weboldaladat böngészve egyszer csak egy fehér képernyő vagy egy „500 Internal Server Error” felirat fogad, tudod, hogy komoly probléma lépett fel. A WordPress 500-as szerverhiba az egyik leggyakoribb és legfrusztrálóbb hiba, amivel egy weboldal tulajdonos találkozhat – főleg azért, mert elsőre semmilyen konkrét információt nem ad arról, mi okozza. Ebben a cikkben végigvezetünk a leggyakoribb okokon és a bevált megoldási módszereken, hogy minél gyorsabban visszaállíthasd az oldalad működését.
Mi az a 500-as szerverhiba?
A HTTP 500-as hibakód, vagyis az „Internal Server Error” egy általános szerver oldali hibaüzenet. Ez azt jelenti, hogy a szerver valamilyen váratlan állapotba kerülve nem tudta teljesíteni a kérést, de a konkrét okot nem közli a böngészővel. WordPress esetén ez megjelenhet fehér képernyőként (az úgynevezett White Screen of Death formájában), hibaüzenetként a böngészőben, vagy akár csak az adminisztrációs felületet érintheti, miközben a frontend látszólag működik.
Fontos megérteni, hogy a WordPress 500 hiba nem egyetlen konkrét problémára utal – sokkal inkább egy tünet, amelynek hátterében számos különböző ok állhat. Éppen ezért a diagnosztizálás módszeres megközelítést igényel.
A WordPress 500-as szerverhiba leggyakoribb okai
Hibás vagy inkompatibilis bővítmény
A legtöbb esetben egy nemrég telepített vagy frissített bővítmény (plugin) áll a hiba hátterében. Ha a bővítmény kódja hibás, vagy nem kompatibilis a WordPress aktuális verziójával, illetve egy másik bővítménnyel, az könnyen 500-as hibát okozhat. Ez az egyik legegyszerűbben orvosolható ok.
Én mindig azt a kérdést teszem fel az ügyfélnek, hogy mit csinált legutoljára a weboldalon, miután előjött az 500-as hiba. Az esetek 99%-ban azonnal meglesz mi okozta a gondot. Ha nem csinált semmit, akkor irány a szerverre és ott szétnéztni.
Sérült vagy inkompatibilis sablon (téma)
Az aktív WordPress téma szintén okozhat szerver oldali hibát, különösen akkor, ha a sablon kódja tartalmaz PHP szintaktikai hibát, vagy nem kompatibilis a szerver PHP verziójával. Frissítések után különösen érdemes ezt gyanúba fogni.
Sérült .htaccess fájl
A .htaccess fájl az Apache webszerverek konfigurációs fájlja, amelyet WordPress is használ az átirányítások és egyéb beállítások kezeléséhez. Ha ez a fájl megsérül – például egy sikertelen WordPress-frissítés vagy egy rosszul konfigurált bővítmény miatt –, az szinte biztosan 500-as hibát eredményez.
PHP memóriakorlát túllépése
Ha a WordPress weboldal kigogy a rendelkezésre álló PHP memóriából, a szerver nem tudja befejezni a kérés feldolgozását, és 500-as hibával válaszol. Ez különösen erőforrásigényes bővítmények vagy nagy forgalom esetén fordulhat elő.
PHP verzióinkompatibilitás
A tárhelyszolgáltató által frissített PHP verzió és az elavult WordPress telepítés, bővítmények vagy témák közötti inkompatibilitás szintén tipikus oka a 500-as hibának.
Hogyan javítsd ki a WordPress 500-as szerverhibát?
1. lépés: Ellenőrizd a szerver hibanaplóját
Az első és legfontosabb lépés a szerver error log (hibanapló) ellenőrzése. Ez a fájl általában a tárhely fájlkezelőjében vagy FTP-n keresztül érhető el, általában error_log vagy php_error.log névvel. A benne található bejegyzések pontos információt adnak arról, hogy melyik fájlban, melyik sorban keletkezett a hiba – ez drámaian lerövidíti a hibakeresést.
2. lépés: Kapcsold ki az összes bővítményt
Ha nem férsz hozzá a WordPress adminisztrációs felületéhez, FTP-n vagy a tárhely fájlkezelőjén keresztül navigálj a /wp-content/plugins/ mappába, és nevezd át a plugins mappát (pl. plugins_disabled névre). Ezzel WordPress nem fogja betölteni a bővítményeket. Ha az oldal ezután betölt, a probléma valamelyik bővítménynél van. Nevezd vissza a mappát, majd egyesével aktiváld újra a bővítményeket, hogy megtaláld a hibásat.
3. lépés: Válts alapértelmezett témára
Hasonló módszerrel tesztelheted a témát is. FTP-n keresztül navigálj a /wp-content/themes/ mappába, és ideiglenesen nevezd át az aktív téma mappáját. WordPress automatikusan egy alapértelmezett témára vált, természetesen ha nem törölted le korábban. Ha ez megoldja a problémát, a hibát az eredeti témában kell keresni – érdemes felvenni a kapcsolatot a téma fejlesztőjével.
4. lépés: Generáld újra a .htaccess fájlt
A sérült .htaccess fájl javítása egyszerű: töröld a meglévő fájlt FTP-n keresztül (előtte érdemes biztonsági másolatot készíteni belőle), majd lépj be a WordPress adminisztrációs felületére, és navigálj a Beállítások → Hivatkozások menüpontra. Kattints a „Változtatások mentése” gombra – WordPress automatikusan létrehoz egy új, helyes .htaccess fájlt.
5. lépés: Növeld a PHP memóriakorlátot
A PHP memóriakorlát növeléséhez nyisd meg a wp-config.php fájlt (a WordPress gyökérkönyvtárában található), és add hozzá a következő sort a „That’s all, stop editing!” sor elé:
define(‘WP_MEMORY_LIMIT’, ‘256M’); vagy define(‘WP_MEMORY_LIMIT’, ‘512M’);
Alternatív megoldásként a .htaccess fájlban is megadhatod: php_value memory_limit 256M vagy 512M. Ha a tárhelycsomag nem teszi lehetővé ezt a beállítást, lépj kapcsolatba a tárhelyszolgáltatóddal.
6. lépés: Ellenőrizd a PHP verziót
A tárhely vezérlőpultján (cPanel, Plesk stb.) általában lehetőség van a PHP verzió manuális megváltoztatására. Ha nemrég frissítette a tárhelyszolgáltatód a PHP verziót, próbálj meg visszatérni az előző verzióra, és ellenőrizd, hogy ez megoldja-e a problémát. Hosszú távon azonban érdemes a bővítményeket és a témát is frissíteni, hogy kompatibilisek legyenek a legújabb PHP verzióval.
7. lépés: Állítsd vissza a WordPress alap fájljait
Ha a fentiek egyike sem segített, lehetséges, hogy maga a WordPress mag sérült meg. Töltsd le a WordPress legfrissebb verzióját a wordpress.org oldalról, csomagold ki, majd FTP-n keresztül töltsd fel a wp-admin és wp-includes mappák tartalmát (a wp-content mappát és a wp-config.php fájlt NE írd felül). Ez visszaállítja az alap WordPress fájlokat anélkül, hogy az adataidat vagy a beállításaidat módosítaná.
Megelőzés: hogyan kerüld el a jövőben?
A WordPress 500-as szerverhiba megelőzése érdekében érdemes néhány bevált gyakorlatot követni. Mindig készíts teljes biztonsági mentést a frissítések telepítése előtt. Bővítményeket és témákat csak megbízható forrásból telepíts, és rendszeresen frissítsd őket. Érdemes egy staging (tesztelési) környezetet is fenntartani, ahol a változtatásokat kipróbálhatod az éles oldal veszélyeztetése nélkül. Ezt kimondottan kötelezőnek tartom nagy forgalmú webshopok esetén.
Fontos az is, hogy a tárhelyszolgáltatód megbízható legyen, és rendelkezzen megfelelő erőforrásokkal. Egy lassú vagy túlterhelt szerver önmagában is okozhat időszakos 500-as hibákat, még akkor is, ha a WordPress telepítéseddel minden rendben van.
Összegzés
A WordPress 500 hiba ijesztőnek tűnhet, de a legtöbb esetben módszeresen, lépésről lépésre megoldható. A legfontosabb, hogy kezdd a szerver hibanaplójának ellenőrzésével, majd haladj végig a bővítmények, a téma, a .htaccess fájl és a memóriakorlát vizsgálatán. Ha ezek egyike sem vezet eredményre, a WordPress alap fájljainak visszaállítása általában megoldja a problémát. Ha pedig minden próbálkozás után sem sikerül javítani a hibát, ne habozz szakember segítségét kérni – egy tapasztalt WordPress fejlesztő gyorsan azonosítani tudja a problémát, és visszaállítja az oldalad teljes működőképességét.