Een WordPress-site die plotseling een wit scherm, een kritieke fout of een 500-melding toont, is schrikken, maar bijna elke fout heeft een bekende oorzaak en oplossing. In dit artikel loop je de meest voorkomende WordPress-foutmeldingen langs, met per fout de waarschijnlijke oorzaak en de stappen om hem te verhelpen.
Maak vóór je iets aanpast een back-up, of gebruik de dagelijkse back-up van Webosa. De meest gemaakte fout bij het oplossen van problemen is aanpassingen doen zonder terugweg. Zie back-up maken en herstellen.
De foutmeldingen in het kort
| Foutmelding | Meest waarschijnlijke oorzaak | Eerste stap |
|---|---|---|
| Wit scherm (WSOD) | Plug-in- of themaconflict, of te weinig geheugen | Plug-ins uitschakelen, thema wisselen |
| Er heeft zich een kritieke fout voorgedaan | PHP-fout in een plug-in of thema | Herstel-e-mail openen, debug aanzetten |
| 500 internal server error | Beschadigde .htaccess of geheugentekort | .htaccess vernieuwen |
| Error establishing a database connection | Verkeerde databasegegevens of database offline | wp-config.php controleren |
| 502 / 504 gateway error | Server tijdelijk overbelast of traag script | Even wachten, daarna zware plug-ins nalopen |
Het witte scherm (WSOD)
Bij het "white screen of death" toont je site een lege witte pagina zonder enige melding. Dit komt vrijwel altijd door een conflict met een plug-in of thema, of doordat een script het geheugen opmaakt.
- Schakel al je plug-ins uit. Kun je nog inloggen, doe dat dan via het beheerscherm. Kun je dat niet, hernoem dan via de bestandsbeheerder in het Beheerpaneel de map
wp-content/pluginstijdelijk, zodat WordPress alle plug-ins overslaat. - Werkt je site weer, schakel de plug-ins dan één voor één in tot het witte scherm terugkeert. Die laatste plug-in is de veroorzaker.
- Blijft het scherm wit, wissel dan tijdelijk naar een standaardthema om je thema uit te sluiten.
Er heeft zich een kritieke fout voorgedaan
Deze melding vervangt in recentere WordPress-versies vaak het witte scherm. WordPress stuurt dan een herstel-e-mail naar het beheerdersadres met een link waarmee je in een veilige modus inlogt en de veroorzakende plug-in kunt uitschakelen. Zet je die e-mail niet ontvangt of meer informatie wilt, activeer dan tijdelijk de debugmodus door in wp-config.php de regel define('WP_DEBUG', true); op te nemen. Je ziet dan welk bestand de fout veroorzaakt. Zet debug daarna weer uit, want je wilt geen fouten aan bezoekers tonen.
500 internal server error
Een 500-fout is een algemene serverfout. De twee meest voorkomende oorzaken:
- Een beschadigde
.htaccess. Hernoem dit bestand in de hoofdmap tijdelijk naar.htaccess-ouden genereer het opnieuw door in WordPress je permalink-instellingen te openen en op te slaan. - Te weinig PHP-geheugen. Een zware plug-in kan de geheugenlimiet overschrijden. Verhoog de PHP-geheugenlimiet, of schakel de zware plug-in uit.
Error establishing a database connection
Deze fout betekent dat WordPress geen verbinding krijgt met de database. Loop dit na:
- Controleer in
wp-config.phpofDB_NAME,DB_USER,DB_PASSWORDenDB_HOSTexact kloppen met je database in het Beheerpaneel. - Open phpMyAdmin in het Beheerpaneel om te controleren of de database bereikbaar is en de tabellen aanwezig zijn.
- Is de database recent hersteld of verplaatst, dan kloppen de gegevens in
wp-config.phpmogelijk niet meer. Pas ze aan.
502 en 504 gateway error
Een 502 of 504 wijst op een server die tijdelijk niet of te traag antwoordt, bijvoorbeeld door een korte piek of een langlopend script. Vaak is de fout na een paar minuten vanzelf weg. Blijft hij, controleer dan of een zware plug-in of een externe koppeling het proces ophoudt. Blijft je site onbereikbaar, kijk dan op de netwerkstatus of er onderhoud of een storing speelt.
Nog steeds een fout na een update?
Ontstond de fout direct na een update, dan is de update de meest waarschijnlijke oorzaak. Zet je back-up van vlak daarvoor terug en werk daarna gecontroleerder bij. Lees hoe dat veilig gaat in WordPress-updates uitvoeren. Draait je site op een verouderde PHP-versie, dan kan ook dat fouten geven, zie PHP-versie wijzigen in WordPress.
Veelgestelde vragen
Ik kan niet meer inloggen op mijn beheerscherm. Wat nu?
Werk dan via de bestandsbeheerder in het Beheerpaneel. Door de map wp-content/plugins tijdelijk te hernoemen, schakel je alle plug-ins uit en kun je meestal weer inloggen om de oorzaak op te sporen.
Wat is de snelste oplossing als niets werkt?
Een recente back-up terugzetten. Daarmee is je site direct weer zoals hij was vóór het probleem. Daarna kun je rustig uitzoeken wat er misging.
Hoe zet ik de debugmodus veilig aan?
Zet in wp-config.php tijdelijk WP_DEBUG op true om de fout te zien, en zet hem daarna weer op false. Laat debug nooit permanent aan staan op een live-site, want foutmeldingen geven aanvallers informatie.
Ligt het aan mijn hosting of aan WordPress?
Een wit scherm, een kritieke fout of een databaseverbindingsfout ligt vrijwel altijd binnen WordPress (een plug-in, thema of instelling). Een aanhoudende 502 of 504 kan op de server wijzen; controleer dan eerst de netwerkstatus.
Wil je een omgeving die op WordPress is afgestemd, met PHP 8.5 en dagelijkse back-ups? Bekijk WordPress-hosting bij Webosa.