WordPress white screen of death oplossen

Je opent je website en ziet niets. Geen logo, geen foutmelding, alleen een leeg wit scherm, en vaak doet het dashboard ook niet meer mee. De WordPress white screen of death los je op door eerst de cache uit te sluiten, daarna plugins en het thema uit te schakelen via de bestandsbeheerder of SFTP, het PHP-geheugen te verhogen en met de debug-modus de echte foutmelding te achterhalen. Je site is niet weg, want je bestanden en database staan nog gewoon op de server. Hieronder loop ik de oorzaken langs van waarschijnlijk naar zeldzaam.

Wat het witte scherm betekent

Een wit scherm in WordPress betekent bijna altijd dat een PHP-fout het opbouwen van de pagina halverwege stopt, terwijl foutmeldingen op een live site verborgen zijn. Er is dan letterlijk niets om te tonen. Sinds WordPress 5.2 zie je in plaats van het lege scherm vaak de melding Er heeft zich een kritieke fout voorgedaan op deze site. Dat is hetzelfde probleem met een vriendelijker gezicht, en de aanpak staat in er heeft zich een kritieke fout voorgedaan oplossen. WordPress stuurt in dat geval ook een mail naar het beheerdersadres met een link naar de herstelmodus, waarmee je ondanks de fout kunt inloggen. Die mail is het eerste wat ik zoek.

Het tweede wat ik check, is waar het scherm wit is. Is alleen de voorkant wit en werkt /wp-admin nog, dan zit de fout vrijwel zeker in je thema of in een plugin die alleen aan de voorkant draait. Is alles wit, dan kijk ik eerst naar plugins. Sluit daarnaast uit dat je naar een oude versie kijkt. Open de site in een privévenster of op je telefoon via mobiele data. Zie je hem daar wel, dan is er niets kapot en moet je alleen de cache legen. Het witte scherm is een van de fouten uit het overzicht WordPress-fouten oplossen, waar je ook de verwante meldingen vindt.

Plugins en thema uitschakelen zonder dashboard

De meest voorkomende oorzaak van een wit scherm is een plugin, vaak direct na een update of installatie, en die schakel je ook zonder dashboard uit door de pluginmap te hernoemen. Kun je nog inloggen, deactiveer dan alle plugins via Plugins > Geïnstalleerde plugins en zet ze één voor één terug. Lukt inloggen niet, dan werk je via de bestanden.

1. Open de File Manager in je hostingpaneel of maak verbinding via SFTP.
2. Ga naar de map wp-content en hernoem plugins naar plugins_uit. WordPress schakelt daarmee alle plugins tegelijk uit.
3. Herlaad je site. Is het scherm weg, dan lag het aan een plugin.
4. Geef de map zijn oude naam terug en hernoem daarbinnen de plugins één voor één, tot het witte scherm terugkomt. De laatst hernoemde is de veroorzaker.
5. Blijft het wit, hernoem dan in wp-content/themes de map van je actieve thema. WordPress valt terug op een standaardthema als dat geïnstalleerd is.

Die laatste voorwaarde vergeten mensen vaak. Heb je alle standaardthema’s als Twenty Twenty-Five verwijderd, dan heeft WordPress niets om op terug te vallen en blijft het scherm wit. Ik laat daarom altijd één standaardthema staan. Werk je met SSH, dan gaat het sneller met WP-CLI. Met wp plugin deactivate --all zet je alle plugins uit en met wp theme activate twentytwentyfive wissel je van thema. Komt de fout uit het thema, dan zit hij meestal in maatwerk in functions.php, bijvoorbeeld een ontbrekende puntkomma na een snelle aanpassing. Hoe je zulke wijzigingen veiliger doet, lees je in WordPress-code bewerken.

Geheugenlimiet en PHP-versie

Is het geheugen dat PHP per aanvraag mag gebruiken op, dan stopt de pagina halverwege en blijft het scherm wit. Dat gebeurt bij zware plugins, grote imports of een pagebuilder met veel elementen op één pagina. Binnen WordPress verhoog je het met de regel define('WP_MEMORY_LIMIT', '256M'); in wp-config.php, boven de regel waarin staat dat je moet stoppen met bewerken. Wat veel uitleg online vergeet, is dat die instelling nooit hoger kan dan de limiet die de server toestaat. WordPress vraagt om meer, maar PHP beslist.

De serverlimiet pas je daarom ook aan. Op onze shared hosting doe je dat zelf in cPanel > Select PHP Version > Options, bij memory_limit. In datzelfde scherm wissel je van PHP-versie, en dat is de andere bekende oorzaak. Een oude plugin die niet werkt op PHP 8, of juist een nieuwe plugin die een recente versie eist, geeft precies dit lege scherm. Heb je kort ervoor van versie gewisseld, zet hem dan tijdelijk terug en zoek uit welk onderdeel niet meekan. In PHP-versie updaten lees je hoe je dat netjes test. Mijn advies is wel om het geheugen niet eindeloos op te hogen. Heeft een site steeds meer nodig, dan is er meestal een plugin die te veel doet.

De echte foutmelding opzoeken

Helpen plugins, thema en geheugen niet, dan zoek je de foutmelding op in het foutlog, want daarin staat precies welk bestand en welke regel de fout geeft. Op onze servers schrijft PHP fouten naar een bestand error_log in de map waar de fout optreedt. Staat daar niets bruikbaars, zet dan de debug-modus aan. Dan komen de fouten in wp-content/debug.log, zonder dat je bezoekers ze zien.

Lees dan het pad in de melding. Staat er wp-content/plugins/pluginnaam/ in, dan weet je wie de schuldige is. Staat er wp-includes of wp-admin, dan is een core-update waarschijnlijk niet goed doorgekomen. In dat geval download je dezelfde WordPress-versie, en upload je de mappen wp-admin en wp-includes opnieuw. Je wp-content en wp-config.php laat je met rust, want daar staan je eigen bestanden en instellingen. Wil je gewoon zo snel mogelijk terug naar een werkende site, dan kan dat ook met een back-up van vóór het probleem. Hoe dat werkt, staat in back-up terugzetten. Ontstond het scherm direct na een update, kijk dan ook bij site kapot na een update.

Wat we bij Surver standaard regelen, is dat je dit soort zoekwerk niet blind hoeft te doen. Op de shared pakketten heb je File Manager, SSH en WP-CLI, en zet je een back-up los terug met JetBackup 5 in cPanel. Maak vóór het terugzetten wel eerst een back-up van de huidige staat, want die wordt niet automatisch bewaard. Met die middelen los je het op onze managed WordPress hosting zelf op. Wil je liever dat wij elke minuut controleren of je site bereikbaar is en de updates voor je doen, dan past WordPress onderhoud beter.

Veelgestelde vragen

Ben ik mijn content kwijt bij een wit scherm?

Nee. Je pagina’s, berichten en afbeeldingen staan nog in de database en in wp-content, alleen het opbouwen van de pagina gaat mis. Zodra de fout weg is, staat alles er weer.

Waarom is alleen mijn dashboard wit?

Dan zit de fout meestal in een plugin die alleen in het beheer laadt, zoals een SEO- of pagebuilderplugin. Schakel de plugins uit door de map te hernoemen en zet ze één voor één terug.

Kan een wit scherm door een hack komen?

Dat kan, bijvoorbeeld als kwaadaardige code een bestand beschadigt. Zie je onbekende bestanden of beheerders, behandel het dan als een hack en niet als een gewone fout. Op Surver shared hosting scant Imunify bij elke bestandswijziging op malware, zodat verdachte bestanden direct op slot gaan.