Når en opdatering af WordPress fejler: rolig fejlsøgning trin for trin

En fejlet opdatering af WordPress ser voldsom ud, men følger næsten altid et kendt mønster med en kendt løsning.

Læs fejlbeskeden, fjern det, der blokerer, og få sitet op igen. Find derefter årsagen, så det ikke sker igen. Det vigtigste er ikke at klikke rundt i panik.

Hvem guiden er til

Guiden er til dig, der lige har trykket “Opdater” og nu ser et af disse:

• en hvid side uden indhold
• en besked om en kritisk fejl eller en “Fatal error”
• teksten “Briefly unavailable for scheduled maintenance”
• et site, der virker, men ser helt forkert ud

Er skærmen helt hvid, og ved du ikke, om det skyldes en opdatering, så start med Hvid skærm på dit WordPress-site. Er det din webshop, der driller, så se WooCommerce efter opdatering.

Hvad betyder fejlbeskeden?

Fejlbeskeden er dit bedste spor. Her er de mest almindelige, og hvad de typisk betyder.

Det ser du	Det betyder typisk
“Briefly unavailable for scheduled maintenance”	Opdateringen blev afbrudt, og filen .maintenance ligger stadig
“Fatal error” med en sti som /wp-content/plugins/navn/	Plugin’et i stien er synderen
Samme fejl, men stien peger på /wp-content/themes/	Det er dit tema
“There has been a critical error on this website”	WordPress har fanget en alvorlig fejl og sendt en mail til administratoren
“Allowed memory size exhausted”	Serveren har ikke hukommelse nok til opdateringen
Hvid skærm uden tekst	En PHP- eller databasefejl, der ikke vises. Slå fejlloggen til (se nedenfor)

På et dansk site er beskeden om den kritiske fejl oversat. Den betyder det samme.

Sitet hænger i vedligeholdelsestilstand

Under en opdatering lægger WordPress en fil, der hedder .maintenance, i roden af sitet. Så længe den ligger der, ser besøgende kun beskeden om planlagt vedligehold. Bliver opdateringen afbrudt, bliver filen liggende.

Sådan fjerner du den:

1. Log ind på dit hostingpanel og åbn filhåndteringen, eller forbind med FTP eller SFTP.
2. Gå til den mappe, hvor wp-config.php ligger.
3. Slå visning af skjulte filer til, hvis du ikke kan se filen. Den starter med et punktum.
4. Slet .maintenance.
5. Genindlæs sitet og tjek under Opdateringer i wp-admin, om alt blev opdateret.

Blev opdateringen kun halvt færdig, så kør den igen, når sitet er oppe.

Et plugin har væltet sitet

Det er den mest almindelige årsag.

Fra WordPress 5.2 sender WordPress en mail til administratoradressen, når en fatal fejl stopper sitet. Mailen indeholder et link til gendannelsestilstand. Her er det plugin, der fejler, sat på pause for dig, så du kan logge ind og deaktivere det.

Kommer mailen ikke, eller kan du ikke logge ind, så gør det via filerne:

1. Gå til wp-content/plugins via FTP eller filhåndteringen.
2. Omdøb plugin’ets mappe, fx fra navn til navn-av. Så kan WordPress ikke finde det, og plugin’et er slået fra.
3. Tjek, at sitet virker igen.
4. Slet plugin’et i wp-admin og installer en frisk version.

Har du WP-CLI, kan du i stedet køre wp plugin deactivate navn.

Ved du ikke, hvilket plugin det er, kan du omdøbe hele mappen plugins til plugins_old. Så er alle plugins slået fra på én gang. Husk at skifte navnet tilbage og aktivere dem ét ad gangen bagefter.

Find fejlen med debug-loggen

Viser sitet en hvid skærm uden tekst, så slå WordPress’ fejllog til. Det gør du i wp-config.php, før linjen “That’s all, stop editing!”.

• define( 'WP_DEBUG', true ); slår fejlsøgning til.
• define( 'WP_DEBUG_LOG', true ); gemmer fejlene i filen wp-content/debug.log.
• define( 'WP_DEBUG_DISPLAY', false ); sørger for, at besøgende ikke ser fejlene.

Genindlæs sitet og åbn debug.log. Den nyeste “Fatal error” viser filen og linjen, der fejler. Sæt WP_DEBUG tilbage til false, når du er færdig.

Er det temaet eller selve WordPress?

Peger fejlen på dit tema eller på WordPress’ egne filer i wp-admin eller wp-includes, så skal du ikke rode med enkelte filer. Gendan din seneste backup, og prøv opdateringen igen med bedre forberedelse.

Det betyder, at du tester opdateringen et sted, hvor ingen kan se det, før du kører den på det rigtige site. Læs hvordan i Staging: test sikkert og Opdater WordPress sikkert.

Har du ingen backup, så stop her og få hjælp. Ellers risikerer du at gøre skaden større.

Hvorfor fejlede opdateringen?

Når sitet er oppe igen, så find årsagen. Ellers sker det igen ved næste opdatering. De typiske årsager er:

• En forældet PHP-version. Nye versioner af plugins kræver ofte en nyere PHP, end serveren kører.
• For lidt hukommelse. Fejlen “Allowed memory size exhausted” betyder, at WordPress ikke har hukommelse nok. Det kan din host ofte hæve.
• Plugins, der ikke spiller sammen. To plugins, der hver især virker fint, kan vælte sitet sammen.

Fejler opdateringerne igen og igen, er det ikke uheld. Så er der noget i miljøet, der skal ordnes, og det er værd at få gennemgået.

WordPress har også selv fået bedre sikkerhedsnet. Fra WordPress 6.6 ruller automatiske plugin-opdateringer selv tilbage til den forrige version, hvis de giver en fatal fejl. Det gælder kun automatiske opdateringer, ikke dem du selv starter.

Overvejer du at vente med en opdatering, så læs Hvornår skal du vente med en opdatering?.

Det ser vi oftest

Store opdateringer på en travl dag. En stor opdatering af en page builder eller WooCommerce, kørt direkte på det rigtige site uden test. Det er en klassiker, og den kan undgås med et testmiljø.

Sites, hvor meget hænger på ét plugin. På Eater er WooCommerce motoren i en eventplatform. Gæsterne køber billetter og får dem scannet ved døren. På et site som det skal en opdatering testes, før den køres live.

Opdateringer, der har ventet for længe. Jo flere versioner et plugin er bagud, jo større er springet. Og jo større er risikoen for, at noget går i stykker.

Hvad koster det hos os?

Er sitet nede lige nu, så ring på 71 99 01 02 (man-fre 9-15). Kritiske fejl tager vi som regel samme dag, og 95 % af alle sager er løst inden for 24 timer.

	Pris ekskl. moms
WordPress-hjælp	1.200 kr./t, afregnes pr. kvarter (fra 300 kr.)
Prioritet, 5 timer	5.700 kr. (1.140 kr./t)
Prioritet, 10 timer	10.800 kr. (1.080 kr./t)
Prioritet, 20 timer	20.000 kr. (1.000 kr./t)

Med Prioritet køber du timer på forhånd. Dine opgaver ryger forrest i køen, og vi svarer normalt inden dagen er omme.

Timerne gælder i 12 måneder, og det er et engangskøb, ikke et abonnement. Der er ingen tilbud frem og tilbage og ingen småfakturaer.

Vil du helst slippe for at tænke på opdateringer, så er WebProtect til dig. For 299 kr./md. ekskl. moms opdaterer vi WordPress, tema og plugins 1-2 gange om ugen.

Driller en opdatering, ruller vi tilbage og finder en løsning. Har du brug for hjælp med det samme, så se Prioritet.

Spørgsmål og svar

Hvad gør jeg, når en opdatering af WordPress fejler?

Læs fejlbeskeden først. Den peger ofte direkte på det plugin eller tema, der driller. Hænger sitet i vedligeholdelsestilstand, så slet filen .maintenance. Er det et plugin, så omdøb dets mappe, så sitet kommer op igen.

Hvorfor står der ‘Briefly unavailable for scheduled maintenance’?

WordPress lægger en fil, der hedder .maintenance, i roden af sitet under en opdatering. Bliver opdateringen afbrudt, bliver filen liggende. Slet den via FTP eller filhåndteringen i dit hostingpanel.

Hvordan deaktiverer jeg et plugin, når jeg ikke kan komme ind i wp-admin?

Omdøb plugin’ets mappe i wp-content/plugins via FTP eller filhåndteringen hos din host. Har du WP-CLI, kan du bruge kommandoen wp plugin deactivate efterfulgt af plugin’ets navn.

Hvorfor fejler mine WordPress-opdateringer igen og igen?

Gentagne fejl skyldes som regel miljøet og ikke uheld. Typiske årsager er en forældet PHP-version, for lidt hukommelse på serveren eller plugins, der ikke spiller sammen.

Hvad koster det at få Magio til at redde en fejlet opdatering?

WordPress-hjælp koster 1.200 kr./t ekskl. moms og afregnes pr. kvarter. Med Prioritet køber du timer på forhånd og kommer forrest i køen.