@harrasteblogi JUURI NYT
--:--

Tilaa uutiskirje

Saat tuoreimmat 10 uusinta artikkelia kerran viikossa sähköpostiisi.

Tilaa uutiskirje

WordPress White Screen of Death -korjaus

WordPress White Screen of Death -korjausYksi WordPressin tunnetuimmista ongelmista on niin sanottu White Screen of Death (WSOD), jossa verkkosivusto tai hallintapaneeli muuttuu täysin valkoiseksi ilman näkyvää virheilmoitusta. Ongelma voi ilmetä heti päivityksen jälkeen, uuden lisäosan asentamisen yhteydessä tai palvelinympäristön muutoksen seurauksena. Vaikka valkoinen sivu voi näyttää vakavalta, sen taustalla on yleensä yksittäinen tekninen virhe, joka voidaan selvittää järjestelmällisellä vianmäärityksellä.

Mikä on White Screen of Death?

White Screen of Death tarkoittaa tilannetta, jossa PHP:n suoritus keskeytyy ennen kuin WordPress ehtii näyttää varsinaisen sivun.

Ongelma voi näkyä esimerkiksi:

  • koko verkkosivustolla
  • WordPress-hallintapaneelissa
  • yksittäisellä sivulla
  • WooCommerce-kaupassa
  • kirjautumissivulla
  • vain tietyillä käyttäjillä

Koska virheilmoitusta ei aina näytetä, ongelman syy täytyy selvittää muilla tavoilla.

Yleisimmät syyt

WSOD johtuu yleensä yhdestä tai useammasta teknisestä ongelmasta.

Tavallisimpia syitä ovat:

  • lisäosan virhe
  • teeman ohjelmointivirhe
  • PHP Memory Limit -rajan ylittyminen
  • WordPress-päivityksen epäonnistuminen
  • PHP-version yhteensopimattomuus
  • vioittuneet WordPress-tiedostot

Ongelma ilmenee usein heti jonkin muutoksen jälkeen.

Ota käyttöön WP_DEBUG

Ensimmäinen vaihe on selvittää, mikä aiheuttaa valkoisen näytön.

WP_DEBUG auttaa näyttämään esimerkiksi:

  • PHP Fatal Error -virheet
  • varoitukset
  • Notice-ilmoitukset
  • tiedostonimen
  • rivinumeron
  • vanhentuneet funktiot

Kehitysympäristössä debug-tila nopeuttaa ongelman paikallistamista huomattavasti.

Tarkista palvelimen virhelokit

Jos debug-tila ei tuota riittävästi tietoa, palvelimen lokit ovat seuraava tutkimuskohde.

Niistä voidaan löytää esimerkiksi:

  • PHP Fatal Error
  • muistivirheet
  • käyttöoikeusongelmat
  • puuttuvat tiedostot
  • aikakatkaisut
  • palvelinvirheet

Virhelokit sisältävät usein tarkimman kuvauksen ongelman syystä.

Poista lisäosat käytöstä

Lisäosat aiheuttavat suuren osan White Screen of Death -ongelmista.

Vianmäärityksessä kannattaa:

  • poistaa kaikki lisäosat käytöstä
  • ottaa ne käyttöön yksi kerrallaan
  • tarkistaa yhteensopivuus
  • päivittää vanhentuneet lisäosat
  • poistaa käyttämättömät lisäosat
  • seurata virhelokeja

Näin ongelmallinen lisäosa löytyy yleensä nopeasti.

Testaa oletusteemalla

Jos lisäosat eivät aiheuta ongelmaa, kannattaa tarkistaa käytössä oleva teema.

Toimenpiteitä voivat olla:

  • vaihtaminen oletusteemaan
  • lapsiteeman poistaminen käytöstä
  • mukautetun ohjelmakoodin tarkistaminen
  • teemapäivitysten asentaminen
  • PHP-virheiden tutkiminen
  • yhteensopivuuden testaaminen

Huonosti kirjoitettu teema voi estää koko sivuston latautumisen.

Tarkista PHP Memory Limit

Muistin loppuminen voi johtaa täysin valkoiseen sivuun.

Tyypillisiä oireita ovat:

  • hallintapaneelin kaatuminen
  • kuvien latausongelmat
  • WooCommerce-virheet
  • epäonnistuneet päivitykset
  • satunnaiset käyttökatkokset
  • hitaasti toimiva sivusto

Ennen muistirajan kasvattamista kannattaa selvittää, mikä kuluttaa muistia eniten.

Tarkista PHP-versio

WordPress, teemat ja lisäosat tarvitsevat yhteensopivan PHP-version.

Tarkista esimerkiksi:

  • käytössä oleva PHP-versio
  • lisäosien vähimmäisvaatimukset
  • teemojen yhteensopivuus
  • poistuneet PHP-funktiot
  • palvelimen asetukset
  • PHP-laajennukset

Virheellinen PHP-versio voi aiheuttaa White Screen of Death -tilanteen heti päivityksen jälkeen.

Tarkista WordPressin ydintiedostot

Joskus ongelma johtuu vioittuneista WordPress-tiedostoista.

Kannattaa tarkistaa:

  • wp-admin
  • wp-includes
  • WordPress Core
  • wp-config.php
  • .htaccess
  • Composer-riippuvuudet

Tarvittaessa ydintiedostot voidaan korvata uusilla ilman, että sisältö tai tietokanta muuttuu.

Tutki tiedostojen käyttöoikeudet

Virheelliset käyttöoikeudet voivat estää WordPressin toiminnan.

Erityistä huomiota kannattaa kiinnittää:

  • tiedostojen oikeuksiin
  • kansioiden oikeuksiin
  • omistajuuteen
  • palvelimen käyttäjätunnukseen
  • PHP:n kirjoitusoikeuksiin
  • välimuistikansioihin

Virheelliset oikeudet voivat estää tiedostojen lukemisen tai kirjoittamisen.

Tyhjennä välimuistit

Joskus ongelma johtuu vanhentuneesta välimuistista eikä itse ohjelmakoodista.

Tyhjennä tarvittaessa:

  • WordPress-välimuisti
  • Redis
  • Varnish
  • CDN-välimuisti
  • selaimen välimuisti
  • OPcache

Välimuistin tyhjentäminen voi palauttaa sivuston toiminnan ilman muita muutoksia.

Palauta varmuuskopio

Jos ongelma alkoi merkittävän päivityksen jälkeen eikä syy löydy nopeasti, varmuuskopio voi olla nopein ratkaisu.

Palautuksessa voidaan hyödyntää:

  • tiedostovarmuuskopioita
  • tietokantavarmuuskopioita
  • hosting-palvelun palautuspisteitä
  • Git-versionhallintaa
  • staging-ympäristöä
  • automaattisia varmistuksia

Palautuksen jälkeen ongelma kannattaa silti selvittää ennen uusien päivitysten tekemistä.

Yleisimmät virheet

White Screen of Death -ongelmien yhteydessä tehdään usein samoja virheitä.

Tyypillisiä ongelmia ovat:

  • muutosten tekeminen suoraan tuotantoon
  • debug-tilan käyttämättä jättäminen
  • varmuuskopioiden puuttuminen
  • kaikkien lisäosien päivittäminen kerralla
  • vanhentuneen PHP-version käyttö
  • virhelokien huomiotta jättäminen

Järjestelmällinen eteneminen säästää aikaa ja vähentää käyttökatkoja.

Parhaat käytännöt

White Screen of Death -ongelmia voidaan ehkäistä seuraavilla tavoilla:

  • testaa päivitykset staging-ympäristössä
  • käytä Git-versionhallintaa
  • ota automaattiset varmuuskopiot
  • pidä WordPress, teemat ja lisäosat ajan tasalla
  • seuraa palvelimen virhelokeja
  • käytä ajantasaista PHP-versiota
  • hyödynnä paikallista kehitysympäristöä

Ennaltaehkäisy on tehokkain tapa välttää pitkät käyttökatkot.

Missä White Screen of Death esiintyy yleisimmin?

WSOD voi ilmetä missä tahansa WordPress-projektissa, mutta riski kasvaa sivuston monimutkaistuessa.

Ongelmaa kohdataan usein:

  • WooCommerce-verkkokaupoissa
  • mukautetuissa teemoissa
  • omissa lisäosissa
  • multisite-ympäristöissä
  • Headless WordPress -projekteissa
  • suurissa yrityssivustoissa

Näissä ympäristöissä automatisoitu testaus ja hallitut päivitysprosessit vähentävät merkittävästi kriittisten virheiden todennäköisyyttä.

Yhteenveto

WordPress White Screen of Death on yleensä seurausta ohjelmointivirheestä, yhteensopivuusongelmasta tai palvelinympäristön muutoksesta. Vaikka virheilmoitus ei aina näy käyttäjälle, ongelma voidaan ratkaista tutkimalla debug-tietoja, palvelimen lokitiedostoja, lisäosia, teemoja ja PHP-ympäristöä järjestelmällisesti.

Kun WordPress-kehityksessä hyödynnetään versionhallintaa, paikallisia kehitysympäristöjä, staging-palvelimia ja säännöllisiä varmuuskopioita, White Screen of Death -tilanteet voidaan ratkaista nopeasti ja niiden vaikutus verkkopalvelun toimintaan jää mahdollisimman vähäiseksi.

🍪