WordPress White Screen of Death oplossen

Het zogeheten White Screen of Death is een leeg, wit scherm zonder foutmelding, waardoor uw WordPress-site of beheeromgeving onbruikbaar lijkt. In dit artikel achterhaalt u stap voor stap de oorzaak en lost u het witte scherm op door debugging in te schakelen, plugins en thema uit te sluiten en zo nodig de geheugenlimiet te verhogen.

Probleem

De WordPress-site of het beheerdersdashboard toont alleen een leeg wit scherm, zonder enige foutmelding of inhoud.

Oorzaak

Een wit scherm ontstaat meestal door een PHP-fout die niet wordt weergegeven omdat foutmeldingen standaard verborgen zijn. De site stopt met laden, maar toont geen melding.

Veelvoorkomende oorzaken zijn een conflicterende of defecte plugin, een fout in het actieve thema of een uitgeputte PHP-geheugenlimiet.

Soms treedt het witte scherm alleen op de front-end of alleen in de beheeromgeving op, wat een aanwijzing geeft over de oorzaak.

Oplossing

Schakel WordPress-debugging in om de verborgen foutmelding zichtbaar te maken, sluit daarna systematisch plugins en het thema uit als oorzaak en verhoog indien nodig de PHP-geheugenlimiet.

Stappenplan

1. Schakel debugging in door WP_DEBUG op true te zetten in wp-config.php.
2. Herlaad de pagina en noteer de getoonde foutmelding en het genoemde bestand.
3. Wijst de fout naar een plugin, schakel die dan uit via de beheeromgeving of door de pluginmap te hernoemen via FTP.
4. Wijst de fout naar het thema, schakel dan tijdelijk over naar een standaardthema.
5. Is er een geheugenfout, verhoog dan de PHP-geheugenlimiet in wp-config.php.
6. Herlaad de site na elke wijziging om te zien of het witte scherm verdwijnt.
7. Zet debugging weer uit zodra het probleem is opgelost.
8. Werk de veroorzakende plugin of het thema bij of vervang deze.

Configuratievoorbeeld: debugging en geheugen in wp-config.php

Schakel debugging in en verhoog zo nodig de geheugenlimiet. Schrijf fouten naar een logbestand in plaats van naar het scherm op een live site:

Voorbeeld:

// Debugging inschakelen, fouten naar logbestand
define( ’WP_DEBUG’, true );
define( ’WP_DEBUG_LOG’, true );
define( ’WP_DEBUG_DISPLAY’, false );

// PHP-geheugenlimiet verhogen
define( ’WP_MEMORY_LIMIT’, ’256M’ );

// Het logbestand verschijnt in:
// wp-content/debug.log

Waarom een wit scherm geen melding toont

WordPress en PHP tonen op productiesites standaard geen foutmeldingen, om gevoelige informatie voor bezoekers verborgen te houden. Treedt er een fatale fout op, dan stopt de uitvoering en blijft er een leeg scherm over. Door debugging tijdelijk in te schakelen, maakt u die verborgen fout alsnog zichtbaar zodat u de oorzaak kunt vinden.

Het uitschakelen van plugins is een beproefde methode om de boosdoener te vinden. Verdwijnt het witte scherm nadat alle plugins uit staan, dan schakelt u ze één voor één weer in tot de fout terugkeert. De laatst ingeschakelde plugin is dan de oorzaak. Hetzelfde principe geldt voor het thema.

Een uitgeputte geheugenlimiet komt vaak voor bij zware plugins of grote sites. Door de limiet te verhogen geeft u WordPress meer ruimte om processen af te ronden. Helpt verhogen structureel, dan is het verstandig met de hostingpartij te overleggen of het hostingpakket nog volstaat voor de site.

Veelgemaakte fouten

• Foutmeldingen op een live site naar het scherm laten schrijven in plaats van naar een logbestand.
• Alle plugins tegelijk weer inschakelen, waardoor de oorzaak onduidelijk blijft.
• Wijzigingen in wp-config.php maken zonder back-up van dat bestand.
• Debugging na het oplossen laten aanstaan.
• De geheugenlimiet eindeloos verhogen zonder de werkelijke oorzaak aan te pakken.
• Geen FTP-toegang regelen terwijl het dashboard onbereikbaar is.

Controle na afloop

1. Controleer of de front-end en de beheeromgeving weer normaal laden.
2. Controleer in debug.log of er geen nieuwe fouten meer worden gelogd.
3. Controleer of de veroorzakende plugin of het thema is bijgewerkt of vervangen.
4. Controleer of debugging weer is uitgeschakeld op de live site.

Praktische tips

• Schrijf fouten naar debug.log in plaats van naar het scherm op een live site.
• Regel vooraf FTP- of bestandsbeheertoegang voor als het dashboard onbereikbaar is.
• Test verdachte plugins eerst op een staging-omgeving.

Veelgestelde vragen

Waarom zie ik geen foutmelding?

WordPress verbergt fouten standaard op live sites; schakel debugging in om de verborgen melding zichtbaar te maken.

Hoe vind ik de veroorzakende plugin?

Schakel alle plugins uit en zet ze één voor één weer aan tot het witte scherm terugkeert.

Moet ik debugging laten aanstaan?

Nee, schakel debugging uit zodra het probleem is opgelost om geen informatie te lekken.

Samenvatting

Het White Screen of Death lost u op door eerst debugging in te schakelen zodat de verborgen PHP-fout zichtbaar wordt. Vervolgens sluit u plugins en het thema systematisch uit als oorzaak en verhoogt u zo nodig de geheugenlimiet. Schrijf fouten naar een logbestand, schakel debugging daarna weer uit en werk de veroorzaker bij.

Gerelateerde artikelen

• WordPress-update veilig uitvoeren
• WordPress-plugin verwijderen
• WordPress-update terugdraaien (rollback)

Komt u er niet uit? Plan een gratis strategiegesprek via https://www.bdmnl.nl/plan.