WordPressin yleisimmät virheet ja niiden korjaus

WordPress on maailman suosituin julkaisujärjestelmä, mutta sen laaja ekosysteemi tarkoittaa myös sitä, että virheitä voi syntyä monesta eri syystä. Teemat, lisäosat, palvelinasetukset, PHP-versiot, välimuisti ja tietokanta vaikuttavat kaikki siihen, miten sivusto toimii. Siksi on tärkeää tietää, miten yleisimmät WordPress-virheet voi korjata itse ennen kuin ne aiheuttavat pidempiaikaista haittaa sivuston käytettävyydelle tai näkyvyydelle.

Tässä artikkelissa käymme läpi WordPressin tyypillisimmät virheet, niiden syyt ja selkeät ohjeet korjaamiseen.

1. White Screen of Death (WSOD)

“Valkoinen kuolemanruutu” on yksi pelätyimmistä WordPress-virheistä: sivu tai admin-näkymä latautuu vain valkoisena ilman mitään virheilmoitusta.

Yleiset syyt:

• rikkinäinen lisäosa tai teema

• PHP-muistin loppuminen

• virheellinen koodi functions.php-tiedostossa

Korjaus:

1. Ota käyttöön debug-tila lisäämällä wp-config.php-tiedostoon:

   define('WP_DEBUG', true);


2. Poista lisäosat käytöstä FTP:llä nimeämällä plugins-kansio.

3. Vaihda teema väliaikaisesti WordPressin oletusteemaan.

4. Nosta PHP memory limit – esimerkiksi arvosta 64M arvoon 256M.

2. 500 Internal Server Error

Tämä virhe voi johtua melkein mistä tahansa, mutta sen voi lähes aina korjata muutamalla perusaskeleella.

Yleisimmät syyt:

• rikkinäinen .htaccess

• liian alhainen PHP-aikaraja

• vanhentuneet lisäosat

Korjaus:

1. Nimeä .htaccess → .htaccess_old

2. Avaa WordPressin asetuksista ”Permalinks” ja tallenna – WordPress luo uuden.

3. Päivitä lisäosat ja teema.

4. Nosta PHP max_execution_time -arvoa 30 → 300.

3. 404-virheet sivuilla

Kun yksittäiset sivut näyttävät 404-virheen mutta admin toimii normaalisti, kyse on lähes aina permalinkeistä.

Korjaus:

• Mene Asetukset → Permalinks

• Valitse nykyinen rakenne uudelleen

• Tallenna

WordPress rakentaa URL-säännöt uudelleen ja virhe poistuu.

4. Tietokantayhteyden virhe (Error Establishing a Database Connection)

Yksi vakavammista virheistä: sivusto ei saa yhteyttä tietokantaan.

Yleisimmät syyt:

• väärät tietokantatunnukset

• tietokanta kaatunut tai täynnä

• palvelin ruuhkautunut

Korjaus:

1. Tarkista wp-config.php:

   • DB_NAME

   • DB_USER

   • DB_PASSWORD

   • DB_HOST

2. Käynnistä MariaDB/MySQL uudelleen, jos voit.

3. Ota käyttöön WordPressin oma korjaustoiminto lisäämällä:

   define('WP_ALLOW_REPAIR', true);


4. Aja osoitteessa /wp-admin/maint/repair.php oleva korjaustoiminto.

5. Kuvien lataus ei toimi (HTTP Error)

Yllättävän yleinen virhe etenkin edullisissa webhotelleissa.

Syitä:

• liian pieni PHP max upload size

• GD/Imagick-kirjaston rajoitukset

• väärät kansio-oikeudet

Korjaus:

• varmista, että wp-content/uploads -kansion oikeudet ovat 755

• nosta upload_max_filesize ja post_max_size arvoihin 32M tai 64M

• vaihda kuvankäsittelykirjasto:

  add_filter( 'wp_image_editors', function() {
return [ 'WP_Image_Editor_GD', 'WP_Image_Editor_Imagick' ];
});


6. Sivusto hidas tai jumittaa

Hidas sivusto ei ole varsinainen virhe, mutta se on yksi WordPressin yleisimmistä ongelmista.

Yleisimmät syyt:

• liikaa lisäosia

• raskas teema

• puuttuva välimuisti

• liian heikko palvelin

Korjaus:

1. Ota käyttöön sivu- ja selainvälimuisti.

2. Poista turhat lisäosat – vähennä alle 20 pluginin tavoitteeksi.

3. Vaihda kevyempään teemaan kuten Astra tai GeneratePress.

4. Käytä PHP 8.1 tai uudempaa.

7. WordPress-päivityksen epäonnistuminen

Joskus päivitykset jäävät jumiin esimerkiksi “Briefly unavailable for scheduled maintenance” -tilaan.

Korjaus:

1. Poista .maintenance-tiedosto FTP:llä.

2. Tarkista oikeudet: WordPress tarvitsee 755-kansiot ja 644-tiedostot.

3. Varmista, ettei palvelintila ole täynnä.

8. Lisäosa kaataa sivuston

Tämä tapahtuu usein, jos lisäosa ei ole yhteensopiva teeman tai PHP-version kanssa.

Korjaus:

1. Poista lisäosa käytöstä FTP:llä nimeämällä aikaisempi plugins-kansio.

2. Aktivoi plugin kerrallaan ja löydä kaataja.

3. Varmista lisäosan päivitys tai korvaava vaihtoehto.

9. XML-RPC-hyökkäykset ja brute force -yritykset

XML-RPC on hyökkääjien yleinen kohde, koska se mahdollistaa kirjautumisen ulkoisesti.

Korjaus:

• estä XML-RPC kokonaan lisäosalla tai .htaccess-säännöllä

• ota käyttöön 2FA

• rajoita kirjautumisyrityksiä

• käytä palomuuria (esim. Cloudflare tai WordPress Security -lisäosia)

10. “Too Many Redirects” -virhe

Tämä syntyy, jos sivuston URL-asetukset tai HTTPS-uudelleenohjaukset menevät ristiin.

Yleisimmät syyt:

• URL vaihtunut, mutta asetuksia ei päivitetty

• plugin ohjaa väärin

• Cloudflare-asetuksissa Force HTTPS + SSL flexible käytössä

Korjaus:

1. Tarkista WordPress URL ja Site URL asetuksista.

2. Nollaa .htaccess-tiedosto.

3. Käytä Cloudflare-asetuksissa “Full (strict)” SSL -tilaa.

11. Virheellinen JSON Response Gutenbergissa

Tämä on Gutenberg-editorin yleinen virhe, joka johtuu useista syistä.

Korjaus:

• nosta PHP max_input_vars arvoon vähintään 5000

• tarkista permalinks

• poista välimuisti käytöstä

• päivitä REST API -toiminnot lisäosista

12. Cron-tehtävät eivät toimi

Sisäinen WP-cron voi lakata toimimasta, mikä vaikuttaa ajoitettuihin julkaisuihin, varmuuskopioihin ja päivityksiin.

Korjaus:

• ota käyttöön oikea cron palvelimelta

• poista WP-cron käytöstä wp-config:ssa:

  define('DISABLE_WP_CRON', true);


13. PHP-muistin loppuminen

“OOM: Out of memory” -virhe kaataa sivuston tai adminin.

Korjaus:
Lisää wp-config.php:

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

Useimmat ongelmat ratkeavat tällä.

14. Tietoturvavaroitukset ja haittakoodit

WordPress voi varoittaa epäilyttävistä tiedostoista, erityisesti teemoissa tai lisäosissa.

Korjaus:

• skannaa lisäosat ja teemat

• vaihda uuteen versioon

• käytä Wordfenceä, iThemes Securityä tai WP Cerberiä

• palauta varmuuskopio

15. Admin näyttää rikkinäiseltä tai oudon näköiseltä

Tämä johtuu usein välimuistista tai puuttuvista CSS- ja JS-tiedostoista.

Korjaus:

• vaihda selainta tai puhdista cache

• tarkista palvelimen mod_security-estot

• varmista oikeat tiedostooikeudet