WordPress blijft hangen in onderhoudsmodus

Je wilt even snel een plugin updaten of een thema aanpassen, en ineens zie je op je website alleen nog: ‘Briefly unavailable for scheduled maintenance. Check back in a minute.’ Vervelend, want het lijkt alsof WordPress is vastgelopen. En nog lastiger: soms weet je niet of het probleem bij WordPress zelf ligt, bij een plugin of bij de server.

Bij Webtify zien we dit vooral gebeuren na een mislukte update. Het goede nieuws is dat WordPress blijft hangen in onderhoudsmodus vaak redelijk simpel op te lossen is. Als je weet waar je moet kijken, kun je je site meestal snel weer bereikbaar maken.

Wat betekent onderhoudsmodus in WordPress?

Wanneer WordPress een update uitvoert, zet het tijdelijk een bestand met de naam .maintenance in de hoofdmap van je website. Daarmee wordt de onderhoudsmodus geactiveerd. Volgens de documentatie van WordPress gebeurt dit automatisch tijdens updates van de core, plugins of thema’s.

Normaal verdwijnt dat bestand vanzelf zodra de update klaar is. Gaat er iets mis tijdens dat proces, dan blijft het bestand staan en denkt WordPress dat de website nog steeds in onderhoud is. Daardoor blijf je de onderhoudsmelding zien.

Waarom blijft WordPress hangen in onderhoudsmodus?

De meest voorkomende oorzaak is een update die niet netjes is afgerond. Dat kan verschillende redenen hebben.

1. Een plugin- of thema-update liep vast

Vaak begint het probleem bij een plugin of thema dat tijdens de update een fout geeft. WordPress zet de onderhoudsmodus aan, maar rondt het proces niet volledig af. Dan blijft het .maintenance-bestand staan.

Dat zie je vooral bij verouderde of slecht onderhouden plugins. Daarom is het slim om niet zomaar alles te laten draaien, maar kritisch te kijken naar wat je echt nodig hebt. In dat opzicht sluit onze blog over WordPress update problemen hier goed op aan.

2. De server was tijdelijk te traag of onderbroken

Een update vraagt servercapaciteit. Als je hosting traag reageert, een time-out optreedt of de verbinding even wegvalt, kan het updateproces halverwege stoppen. De onderhoudsmodus wordt dan wel aangezet, maar niet meer uitgezet.

We zien bij Webtify regelmatig dat dit vaker voorkomt op drukke of minder stabiele hostingomgevingen. Zeker als een website veel plugins gebruikt of al technisch wat zwaarder is.

3. Er draait nog een andere update op de achtergrond

Soms lijkt WordPress vast te hangen, terwijl er nog een updateproces loopt. WordPress controleert zelf of de onderhoudsmodus recent is gestart. In de codebase van WordPress is terug te zien dat zo’n .maintenance-bestand gekoppeld is aan een tijdstempel, waarbij de onderhoudsstatus normaal gesproken tijdelijk is.

Zie je de melding pas net? Wacht dan eerst een paar minuten voordat je ingrijpt. Zeker als je meerdere plugins tegelijk hebt bijgewerkt.

Zo los je het meestal op

Als WordPress blijft hangen in onderhoudsmodus, is dit meestal de snelste aanpak.

• log in op je hosting via bestandsbeheer of FTP
• ga naar de hoofdmap van je WordPress-installatie
• zoek het bestand .maintenance
• verwijder dit bestand
• ververs daarna je website en het dashboard

WordPress adviseert in zijn documentatie precies deze stap wanneer de onderhoudsmelding na een update blijft staan. In veel gevallen is het probleem daarna direct opgelost.

Kun je het bestand niet vinden?

Dan is de kans groot dat verborgen bestanden niet zichtbaar zijn in je bestandsbeheer. Het .maintenance-bestand begint met een punt, en zulke bestanden worden niet altijd standaard getoond. Zet daarom de optie voor hidden files aan.

Lukt het daarna nog steeds niet, dan kan er meer aan de hand zijn. Denk aan een foutieve plugin-update, een conflict in je thema of bredere serverproblemen.

Wat als het probleem terugkomt?

Komt de onderhoudsmodus steeds opnieuw terug, dan is alleen het verwijderen van het bestand niet genoeg. Dan moet je de oorzaak aanpakken. Vaak zit die in een plugin, thema of updateproces dat structureel fout gaat.

Controleer daarom welke update je vlak voor het probleem uitvoerde. Werk plugins één voor één bij in plaats van alles tegelijk. En kijk of er meldingen zijn in je hostinglogs of in WordPress debug-output. Heb je veel uitbreidingen draaien? Dan is het ook slim om te kijken naar de kwaliteit van je installatie en onderhoud. Lees bijvoorbeeld ook of WordPress veilig is en waar beheer vaak misgaat.

Zo voorkom je dat je website opnieuw vastloopt

Voorkomen is hier echt beter dan genezen. Een paar simpele gewoontes maken al veel verschil.

• maak altijd een back-up vóór grote updates
• update plugins en thema’s regelmatig, niet pas na maanden
• gebruik alleen betrouwbare plugins die actief onderhouden worden
• voer updates liever één voor één uit
• zorg voor stabiele hosting en technisch onderhoud

Bij Webtify zien we vaak dat websites met achterstallig onderhoud sneller dit soort problemen krijgen. Niet omdat WordPress onbetrouwbaar is, maar omdat verouderde plugins en rommelige installaties meer risico geven. Ook daarom kiezen veel ondernemers voor structureel beheer, zoals we uitleggen in wat een website abonnement is.

Meestal is het oplosbaar, maar de oorzaak telt

Als WordPress blijft hangen in onderhoudsmodus, is dat meestal geen ramp. In veel gevallen hoef je alleen het .maintenance-bestand te verwijderen en draait je website weer. Maar als dit vaker gebeurt, is dat vaak een teken dat er iets onderliggends niet goed zit in je updates, plugins of hostingomgeving.

Wil je niet elke keer zelf uitzoeken waar het misgaat? Dan is het slimmer om breder naar je websitebeheer te kijken. Zeker als je website belangrijk is voor leads, aanvragen of je dagelijkse bereikbaarheid.