WordPressin tyhjä sivu tai kriittinen virhe: lukekaa virheilmoitus ensin

”Kriittinen virhe” tai tyhjä sivu: sama vika

Tyhjä sivu on useimmiten PHP:n kriittinen virhe (fatal error): jokin sivuston tiedosto pyysi jotain mahdotonta, ja suoritus pysähtyi ennen kuin mitään ehdittiin näyttää. WordPress 5.2:sta lähtien WordPress sieppaa nämä virheet: tyhjän sivun sijaan se näyttää lauseen ”Sivustolla on ollut kriittinen virhe.” ja lähettää sähköpostin sivuston ylläpidon sähköpostiosoitteeseen.

Sivu jää kokonaan tyhjäksi muutamassa tapauksessa: WordPressin vanhempi versio, virhe, joka tapahtuu ennen tämän turvamekanismin latautumista, vakio WP_DISABLE_FATAL_ERROR_HANDLER asetettuna arvoon true tai välimuistilisäosa, joka tarjoilee vian aikana tallentamansa tyhjän sivun. Seuraava menetelmä toimii kaikissa näissä tapauksissa.

Kolme toimenpidettä voi odottaa, kunnes virhe on luettu: WordPressin uudelleenasennus, lisäosien poistaminen ja vanhan varmuuskopion palauttaminen. Kukin niistä voi pyyhkiä asetuksia tai tuoreita tietoja, kun taas virheilmoitus kertoo yleensä tarkasti, mikä osa poistetaan käytöstä, ja kaikki säilyy.

Oikotie: palautustila

Kun WordPress sieppaa virheen, se lähettää sivuston ylläpidon sähköpostiosoitteeseen viestin, jonka otsikko on ”[Sivuston nimi] Sivustollasi on tekninen ongelma”. Viesti nimeää vian aiheuttaneen lisäosan tai teeman, ja siinä on linkki, joka avaa hallintapaneelin palautustilassa.

• Tässä tilassa viallinen osa on keskeytetty vain teidän osaltanne: kävijänne näkevät yhä virheen.
• Poistakaa viestissä nimetty osa käytöstä valikosta Lisäosat tai Ulkoasu > Teemat ja valitkaa sitten hallintapalkista ”Poistu palautustilasta”.
• Linkki on voimassa 24 tuntia, ja WordPress lähettää tällaisen viestin enintään kerran päivässä. Jos viestiä ei tule, katsokaa roskapostikansio ja siirtykää sitten seuraavaan menetelmään.

Lukekaa virhe: virheenkorjausloki

Yhdistäkää sivustoon SFTP:llä tai webhotellin tiedostonhallinnalla, avatkaa juurihakemiston wp-config.php ja korvatkaa rivi define( 'WP_DEBUG', false ); näillä neljällä rivillä:

define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );
define( 'WP_DEBUG_DISPLAY', false );
@ini_set( 'display_errors', 0 );

Rivit sijoitetaan kommentin /* That's all, stop editing! Happy publishing. */ yläpuolelle. Ladatkaa virheellinen sivu uudelleen ja avatkaa sitten wp-content/debug.log. Kun WP_DEBUG_DISPLAY on false, viestit pysyvät tiedostossa eivätkä näy sivulla, jonka kävijänne näkevät.

Jos debug.log jää tyhjäksi tai sitä ei synny, PHP on kirjannut virheen suoraan: etsikää tiedosto error_log sivuston juurihakemistosta tai kansiosta wp-admin, tai webhotellin hallintapaneelin virhelokien osio.

Mitä viesti sanoo ja mikä toimenpide siihen sopii

Kriittinen virhe mahtuu yhdelle riville: virheen tyyppi, sen kuvaus ja sitten in, jota seuraavat tiedoston koko polku ja rivinumero. Polku on hyödyllisin tieto: wp-content/plugins/nimi/ osoittaa lisäosaan, wp-content/themes/nimi/ teemaan.

define( 'WP_MEMORY_LIMIT', '256M' );

Poistakaa viallinen osa käytöstä ilman hallintapaneelia

SFTP:llä tai tiedostonhallinnalla

Nimetkää viestissä mainitun lisäosan kansio uudelleen, esimerkiksi wp-content/plugins/lisaosan-nimi muotoon lisaosan-nimi.off. WordPress ei enää löydä lisäosaa eikä lataa sitä; sen asetukset pysyvät tietokannassa, ja WordPress poistaa sen käytöstä, kun Lisäosat-näkymä seuraavan kerran avataan.

Teeman kansion uudelleennimeäminen kansiossa wp-content/themes palauttaa pääsyn hallintapaneeliin, mutta kävijät näkevät tyhjän sivun niin kauan kuin mikään teema ei ole aktiivinen. Avatkaa heti Ulkoasu > Teemat: WordPress huomaa, että aktiivinen teema on rikki (”Aktivoitu teema on rikkinäinen. Palataan takaisin oletusteemaan.”), ja vaihtaa asennettuun oletusteemaan.

WP-CLI:llä

wp plugin list --status=active
wp plugin deactivate lisaosan-nimi
wp theme list
wp theme activate twentytwentyfive

Ensimmäinen komento tallentaa luettelon aktiivisista lisäosista, mikä on hyödyllistä ennen kuin lisäosia poistetaan käytöstä joukolla. Jos WP-CLI itse pysähtyy virheeseen, lisätkää komentoon --skip-plugins --skip-themes: se käynnistyy silloin lataamatta lisäosia tai teemaa. Kansion wp-content/mu-plugins lisäosat latautuvat silti; jos virhe tulee jostakin niistä, nimetkää sen tiedosto uudelleen.

Kun viesti ei nimeä mitään osaa, wp plugin deactivate --all poistaa käytöstä kaikki lisäosat. Jos sivusto palaa, aktivoikaa ne yksi kerrallaan ja ladatkaa sivusto uudelleen jokaisen välissä: viimeisin ennen virheen paluuta aktivoitu lisäosa on syyllinen.

Kun sivusto toimii taas

1. Palauttakaa define( 'WP_DEBUG', false ); ja poistakaa WP_DEBUG_LOG tiedostosta wp-config.php.
2. Poistakaa wp-content/debug.log: verkosta käsin saavutettavassa kansiossa kuka tahansa voi lukea sen, ja se sisältää palvelimen polkuja.
3. Päivittäkää tai vaihtakaa vian aiheuttanut osa, kun olette lukeneet sen muutoslokin.
4. Tyhjentäkää välimuistilisäosan välimuisti ja webhotellin välimuisti, jos sellainen on.
5. Seuraavaa kertaa varten: testatkaa päivitykset sivuston kopiolla ennen kuin otatte ne käyttöön verkossa.